Search jobs in Switzerland
search_jobsRead-onlyIdempotent
Search open jobs in Switzerland and Liechtenstein by keywords and filters. Only jobs whose advert is still online are returned. Returns up to 20 jobs per page, newest first for filter-only searches; keyword searches rank by relevance, favouring recent adverts and mixing companies. Use get_job for a job's full description.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | A role key from list_categories; requires its category. | |
| limit | No | ||
| query | No | Keywords matched against job title, company and description, with German word forms (e.g. "Pflegefachfrau", "Software Engineer Python"). All words must match; use OR between alternatives, "quotes" for phrases and -word to exclude. Place names match only the text; use cantons to filter by location. | |
| cursor | No | nextCursor of a previous search_jobs result; the other arguments are then ignored. | |
| cantons | No | Two-letter canton codes (ZH, BE, VD, GE, …) or LI for Liechtenstein. | |
| category | No | A category key from list_categories. | |
| workModes | No | ||
| seniorities | No | ||
| workloadMax | No | Highest workload in percent of full time (10–100). | |
| workloadMin | No | Lowest workload in percent of full time (10–100). | |
| salaryStated | No | Only jobs whose advert states a salary. | |
| contractTypes | No | ||
| advertLanguages | No | Language the advert is written in. | |
| excludeAgencies | No | Leave out recruitment agencies. | |
| requiredLanguages | No | Only jobs that require all of these languages. | |
| publishedWithinDays | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | How many open jobs match. | |
| results | Yes | ||
| searchUrl | Yes | The same search on jopp.ai. | |
| nextCursor | Yes | Pass as cursor for the next page; null at the end. |