# Jobs.ch Scraper (`ayen-data/jobs-ch-scraper`) Actor Scrapes job listings from Jobs.ch by search query, location, and Swiss region, returning positions, companies, locations, and full descriptions. Support Bulk scraping with search urls or query. - **URL**: https://apify.com/ayen-data/jobs-ch-scraper.md - **Developed by:** [Anyx Solutions](https://apify.com/ayen-data) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $1.50 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ![banner](https://i.ibb.co/v6yTvWnb/Screenshot-2026-06-20-at-2-07-00-PM.png) ## Jobs.ch Scraper **Collect job listings from Jobs.ch at scale β€” by search query, location, and Swiss region.** The Jobs.ch Scraper extracts structured job data from [Jobs.ch](https://www.jobs.ch), Switzerland's leading job marketplace: positions, companies, locations, employment types, and full descriptions across all Swiss regions and languages (German, French, Italian, English). It is built for recruiters, HR teams, and market researchers monitoring the Swiss employment landscape. ### Features - Extract job data from Jobs.ch at scale - No login required - Extract job details including title, company, location, type, description, images, videos, external apply link, external apply button - Fast and efficient - Cheapest compared to any other similar scraper ### ⚑ Quick start Paste a jobs.ch search URL (filters and all) as a start URL: ```json { "startUrls": [ { "url": "https://www.jobs.ch/en/vacancies/?term=product%20manager" } ], "maxItems": 5 } ```` Or build the search from fields instead of a URL: ```json { "query": "project manager", "location": "zurich", "regions": ["central-switzerland"], "maxItems": 5 } ``` ### 🧩 Input | Field | Type | Required | Default | Description | | -------------------- | ------- | -------- | --------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | `startUrls` | array | no | β€” | Public jobs.ch vacancy search URLs to scrape, including any filters applied on the site. When set, `query`, `location`, and `regions` are ignored. | | `query` | string | no | β€” | Search term (e.g. job title or keyword). | | `location` | string | no | β€” | Location to search in. If provided, it takes precedence over region filtering. | | `regions` | array | no | β€” | One or more Swiss region slugs to filter by (see list below). | | `maxItems` | integer | no | `10` | Maximum number of job listings to scrape **per start URL**. | | `proxyConfiguration` | object | no | `{ "useApifyProxy": true }` | Apify proxy settings. | #### Start URLs Apply any filters on [jobs.ch](https://www.jobs.ch/en/vacancies/) β€” search term, language skills, employment positions, employment types, categories, industries, publication date, and more β€” then copy the browser URL into `startUrls`. Each URL is scraped as its own search, and `maxItems` applies to each one independently. Supported filter parameters include `term`, `location`, `language-skill`, `position`, `employment-type`, `category`, `industry`, `company`, `benefit`, and `publication-date`. ```json { "startUrls": [ { "url": "https://www.jobs.ch/en/vacancies/?language-skill=de&language-skill=en&language-skill=fr&position=1&position=2&position=3&publication-date=7&term=product%20manager" } ] } ```
Available region slugs `abroad`, `central-switzerland`, `city-of-zurich-lake-zurich`, `eastern-switzerland-gr-fl`, `german-part-of-switzerland`, `graubunden`, `mittelland-ag-so`, `region-of-basel`, `region-of-bern`, `region-of-fribourg`, `region-of-geneva`, `region-of-neuchatel-jura`, `region-of-oberwallis`, `region-of-vaud-valais`, `region-of-winterthur-schaffhausen`, `region-of-zurich-schaffhausen`, `rheintal-fl-sargans-linth`, `st-gall-appenzell`, `thurgau-lake-constance`, `ticino`, `western-switzerland`, `wil-toggenburg`, `zurich-oberland`, `zurich-unterland-limmattal`
### πŸ“€ Output Each scraped job is pushed to the dataset as one record. #### Fields | Field | Type | Description | | ------------------------------ | -------------- | ---------------------------------------------------- | | `id` | string | Job listing ID. | | `url` | string | Public Jobs.ch job URL. | | `type` | string\[] | Employment type(s) (e.g. Festanstellung, Praktikum). | | `positionName` | string | Job title. | | `company` | string | Company name. | | `companyLogo` | string | null | Company logo URL. | | `companyDescription` | string | null | Company lead text. | | `postedAt` | string | null | Publication date (ISO 8601). | | `expiredAt` | string | null | Publication end date (ISO 8601). | | `isExpired` | boolean | Whether the listing has expired. | | `location` | string | Combined street, zip, and place. | | `street` / `place` / `zipcode` | string | Address parts. | | `externalLink` | string | External listing URL. | | `externalApplyLink` | string | External application URL. | | `descriptionHTML` | string | Job description as HTML. | | `description` | string | null | Job description as plain text. | | `images` | array | Listing images. | | `videos` | array | Listing videos. |
Example output ```json { "id": "f2db64e7-0e5a-4226-988f-955450698d83", "url": "https://www.jobs.ch/de/stellenangebote/detail/f2db64e7-0e5a-4226-988f-955450698d83", "type": ["Festanstellung"], "positionName": "Dipl. Pflegefachfrau/-mann Privatstation Nachtdienst 50-100%", "company": "HOCH Health Ostschweiz", "companyLogo": "https://media.jobs.ch/images/562d70d3-388e-47ff-8538-dc7f3d77e424/1020x1020.png", "postedAt": "2025-09-03T10:31:59.000Z", "expiredAt": "2026-10-01T00:00:00.000Z", "isExpired": false, "location": "Uznach", "externalLink": "", "street": "", "place": "Uznach", "zipcode": "", "externalApplyLink": "https://career012.successfactors.eu/career?company=KSSG&career_job_req_id=40048", "descriptionHTML": "

Pflege & Therapeutische Dienste Standort Uznach

...
", "description": "Pflege & Therapeutische Dienste Standort Uznach ...", "images": [ { "type": "png", "context": "logo", "url": "https://media.jobs.ch/images/562d70d3-388e-47ff-8538-dc7f3d77e424/1020x1020.png", "updated": "2025-09-03T12:31:59+02:00", "file_name": "1020x1020.png" } ], "videos": [] } ```
### πŸ’‘ Use cases - **Recruiters** monitor Swiss market roles and competitor postings. - **HR professionals** analyze hiring trends across regions and languages. - **Researchers** study employment patterns in Switzerland's multilingual market. - **Aggregators** keep a Swiss jobs directory fresh. ### ❓ FAQ - **What is Jobs.ch?** Switzerland's largest job platform, with positions across all regions and languages. - **How many listings can it extract?** Up to 2000 results per search; use `maxItems` to cap the run. - **What if Jobs.ch changes its site?** We maintain the scraper and update it when major changes affect functionality. ### 🀝 Anyx Solutions Anyx Solutions is an Apify Partner. We build custom scrapers and data-extraction pipelines. - Email: tantosthor@gmail.com # Actor input Schema ## `startUrls` (type: `array`): Public jobs.ch vacancy search pages to scrape. Apply any filters on jobs.ch, then copy the page URL here (for example: https://www.jobs.ch/en/vacancies/?term=product%20manager). When set, the search query, location, and regions fields below are ignored. ## `query` (type: `string`): Keyword to search for, such as a job title, skill, or company name (for example: software engineer). ## `location` (type: `string`): City or place to search jobs in (for example: Zurich). ## `regions` (type: `array`): One or more Swiss regions to limit the search to. Leave empty to search all regions. ## `maxItems` (type: `integer`): Maximum number of job listings to extract. Leave empty to scrape all available results. ## `proxyConfiguration` (type: `object`): Apify proxy settings used for the run. ## Actor input object example ```json { "startUrls": [ { "url": "https://www.jobs.ch/en/vacancies/?term=product%20manager" } ], "query": "project manager", "location": "zurich", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true } } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "startUrls": [ { "url": "https://www.jobs.ch/en/vacancies/?term=product%20manager" } ], "query": "project manager", "location": "zurich", "maxItems": 10 }; // Run the Actor and wait for it to finish const run = await client.actor("ayen-data/jobs-ch-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "startUrls": [{ "url": "https://www.jobs.ch/en/vacancies/?term=product%20manager" }], "query": "project manager", "location": "zurich", "maxItems": 10, } # Run the Actor and wait for it to finish run = client.actor("ayen-data/jobs-ch-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("πŸ’Ύ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # πŸ“š Want to learn more πŸ“–? Go to β†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.jobs.ch/en/vacancies/?term=product%20manager" } ], "query": "project manager", "location": "zurich", "maxItems": 10 }' | apify call ayen-data/jobs-ch-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=ayen-data/jobs-ch-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jobs.ch Scraper", "description": "Scrapes job listings from Jobs.ch by search query, location, and Swiss region, returning positions, companies, locations, and full descriptions. Support Bulk scraping with search urls or query.", "version": "1.0", "x-build-id": "jTISQjpP03eihBQfZ" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ayen-data~jobs-ch-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ayen-data-jobs-ch-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/ayen-data~jobs-ch-scraper/runs": { "post": { "operationId": "runs-sync-ayen-data-jobs-ch-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/ayen-data~jobs-ch-scraper/run-sync": { "post": { "operationId": "run-sync-ayen-data-jobs-ch-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "proxyConfiguration" ], "properties": { "startUrls": { "title": "Start URLs", "type": "array", "description": "Public jobs.ch vacancy search pages to scrape. Apply any filters on jobs.ch, then copy the page URL here (for example: https://www.jobs.ch/en/vacancies/?term=product%20manager). When set, the search query, location, and regions fields below are ignored.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "query": { "title": "Search query", "type": "string", "description": "Keyword to search for, such as a job title, skill, or company name (for example: software engineer)." }, "location": { "title": "Location", "type": "string", "description": "City or place to search jobs in (for example: Zurich)." }, "regions": { "title": "Regions", "type": "array", "description": "One or more Swiss regions to limit the search to. Leave empty to search all regions.", "items": { "type": "string", "enum": [ "abroad", "central-switzerland", "city-of-zurich-lake-zurich", "eastern-switzerland-gr-fl", "german-part-of-switzerland", "graubunden", "mittelland-ag-so", "region-of-basel", "region-of-bern", "region-of-fribourg", "region-of-geneva", "region-of-neuchatel-jura", "region-of-oberwallis", "region-of-vaud-valais", "region-of-winterthur-schaffhausen", "region-of-zurich-schaffhausen", "rheintal-fl-sargans-linth", "st-gall-appenzell", "thurgau-lake-constance", "ticino", "western-switzerland", "wil-toggenburg", "zurich-oberland", "zurich-unterland-limmattal" ], "enumTitles": [ "Abroad", "Central Switzerland", "City of Zurich / Lake Zurich", "Eastern Switzerland / GR / FL", "German part of Switzerland", "GraubΓΌnden", "Mittelland (AG / SO)", "Region of Basel", "Region of Bern", "Region of Fribourg", "Region of Geneva", "Region of NeuchΓ’tel / Jura", "Region of Oberwallis", "Region of Vaud / Valais", "Region of Winterthur / Schaffhausen", "Region of Zurich / Schaffhausen", "Rheintal / FL / Sargans / Linth", "St Gall / Appenzell", "Thurgau / Lake Constance", "Ticino", "Western Switzerland", "Wil / Toggenburg", "Zurich Oberland", "Zurich Unterland / Limmattal" ] } }, "maxItems": { "title": "Maximum items", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Maximum number of job listings to extract. Leave empty to scrape all available results." }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify proxy settings used for the run.", "default": { "useApifyProxy": true } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```