# Jobs.ch Scraper - Jobup.ch, Salaries, Workload & Contacts (`topapi/jobs-ch-scraper`) Actor

Scrape Swiss jobs from jobs.ch and jobup.ch: title, employer, town, canton, workload %, contract type, full ad text, contact and phone, apply link, salary estimate, translation, company profile. Every site filter, links or ids, monitor mode. $0.45 per 1,000 jobs.

- **URL**: https://apify.com/topapi/jobs-ch-scraper.md
- **Developed by:** [Top Api](https://apify.com/topapi) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.45 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## 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.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

### What does Jobs.ch Scraper do?

**Jobs.ch Scraper** reads Swiss job ads from [jobs.ch](https://www.jobs.ch) and its French-speaking sister board [jobup.ch](https://www.jobup.ch) (both run by JobCloud) and returns one row per job: title, employer, town, postcode, canton, workload %, contract type, position level, categories, dates, the full ad text, the contact person and phone, the apply link and e-mail. Built for recruiters, staffing agencies, HR-tech and labour-market teams who need Swiss vacancies as data without copying ads by hand.

Jobs.ch scraper · Jobup.ch scraper · jobs.ch API · Swiss jobs API · Stellenangebote Schweiz · offres d'emploi Suisse

- **Both boards in one run:** jobs.ch had 40,052 jobs and jobup.ch 32,053 on 2026-11-06; a job posted on both comes once, with both sites in `sites`.
- **Every site filter:** keyword, town / postcode / canton, region, category, industry, contract type, position level, workload range (Pensum), employer type (direct or agency), required languages, publication date, sort.
- **Past the 2,000-per-search cap:** the sites show at most 2,000 jobs per search; a bigger search is read window by window (publication date), so a whole category comes back - "pflege" on jobs.ch returned all 5,865 jobs in one run.
- **The full job record on every row, at no extra charge:** ad text (text, HTML and Markdown), contact person, title and phone, apply link and e-mail, street, postcode, canton, coordinates, skills.
- **Options:** the site's salary estimate for the occupation, the site's translation of the ad (EN / DE / FR / IT), the employer's profile and rating breakdown on each job, company profile rows, search statistics, expired-job reports.
- **No login, cookies or API key.**
- **Pay only for delivered rows:** no start fee; filtered-out jobs, cross-site copies and jobs delivered by earlier monitor runs are never charged.
- **Export anywhere:** JSON, CSV, Excel, XML; schedules, webhooks, Make, Zapier, n8n, Google Sheets, Slack, Telegram, Teams, WhatsApp.
- **Works with AI agents:** call it through the Apify API or the Apify MCP server; `compact` rows for LLM pipelines.

### What data can you get from jobs.ch and jobup.ch?

<table>
<tr>
<td>💼 Job title and occupation (`synonym`)</td>
<td>🏢 Employer, company id and profile link</td>
<td>🏷️ Company type: SME, large company, recruitment agency</td>
</tr>
<tr>
<td>📍 Place, street, postcode, town</td>
<td>🗺️ Canton (`canton`, e.g. ZH) and site regions</td>
<td>🌐 Latitude and longitude</td>
</tr>
<tr>
<td>⏱️ Workload (`workload` "80-100%", min, max)</td>
<td>📄 Contract types and position level</td>
<td>🗂️ Categories and industry</td>
</tr>
<tr>
<td>📝 Full ad text (text, HTML, Markdown)</td>
<td>👤 Contact person, role and phone</td>
<td>✉️ Apply link, apply e-mail, method</td>
</tr>
<tr>
<td>📅 Published, first published, end date</td>
<td>💲 Published salary and the site's salary estimate</td>
<td>🗣️ Required languages and levels</td>
</tr>
<tr>
<td>🌍 Translation of the ad (option)</td>
<td>⭐ Employer rating and sub-ratings (option)</td>
<td>🔁 New / updated / expired (monitor mode)</td>
</tr>
</table>

Measured on a 1,000-job run (search "ingenieur", jobs.ch, 2026-11-06): title, employer, place, workload, contract type, position level, categories, regions, dates, ad text and apply link on 100% of rows; occupation 100%, coordinates 96%, postcode 86%, canton 76%, street 64%, required languages 72%, industry 54%; contact person 28%, contact phone 19%, phone numbers anywhere in the ad 38%, contact e-mail 14%, published salary 4%. On a 60-job run with every option on: salary estimate 100%, translation 98%, employer address 93%, employees 77%, employer website 72%.

### How to scrape jobs.ch with Jobs.ch Scraper

1. [Create a free Apify account](https://console.apify.com/sign-up) - $5 of monthly credit, no card needed.
2. Open [Jobs.ch Scraper](https://apify.com/topapi/jobs-ch-scraper) and click **Try for free**.
3. Type one or more **Keywords** (e.g. `Pflege`, `comptable`, `data engineer`), add **Locations** or **Cantons** if you want, and set **Max rows**.
4. Click **Start**. The prefilled form (keyword `python`, 20 rows) finishes in about 2 seconds.
5. Open the **Storage** tab and **Export** as JSON, CSV or Excel - or let a schedule run it for you.

### ⬇️ Input

| Parameter | Type | Description |
|---|---|---|
| **🔍 What to scrape** | | |
| `mode` | Select | `jobs` (default) or `companies` (employer profile rows). |
| `searchQueries` | List | Keywords, each its own search, e.g. `["Pflege", "comptable"]`. Empty = all jobs. In company mode: full-text company search. |
| `locations` | List | Towns, postcodes or canton codes, e.g. `["Zürich", "8001", "GE"]`. Every keyword is searched in every location. |
| `cantons` | List | Canton codes (`ZH`, `BE`, `GE` ...), each one its own search. |
| `sites` | List | `jobs.ch`, `jobup.ch` - both by default. |
| `startUrls` | List | jobs.ch / jobup.ch links: search pages (their filters are kept), category pages, job pages, company pages, a company's job list. |
| `jobIds` | List | Job ids (the UUID in a job link). |
| `companyNames` | List | Employer names, e.g. `["Migros"]` - every company the site files under that name (Migros Aare, Migros Zürich ...). Jobs mode: their open jobs; company mode: their profiles. |
| `companyIds` | List | Company ids or slugs, e.g. `77923-gruner-ag`. |
| **🎯 Filters** (applied by the site) | | |
| `employmentTypes` | List | `permanent`, `temporary`, `freelance`, `internship`, `apprenticeship`, `supplementary income`. |
| `positionLevels` | List | `executive`, `specialist`, `employee`. |
| `workloadMin` / `workloadMax` | Integer | Workload range in %, e.g. 80 / 100. |
| `postedWithinDays`, `postedAfter`, `postedBefore` | Integer / date | First-publication window. |
| `categories`, `regions`, `industries` | List | By the site's names or ids, e.g. `"IT / Telecommunications"`, `"Region of Basel"`. |
| `companyFilter` | Select | `all`, `exclude-hr` (direct employers only), `only-hr` (agencies only). |
| `companyTypes` | List | `sme`, `large`, `agency`. |
| `languageSkills` | List | `de`, `fr`, `en`, `it`. |
| `sortBy` | Select | `relevance` (default), `date` (newest first), `random`. |
| `searchMode` | Select | `classic` (keyword match, default) or `semantic` (the site's new search: "nodejs" finds "Node.js"). |
| **✂️ Refine results** | | |
| `titleKeywords` / `excludeKeywords` | List | Title must / must not contain. |
| `excludeCompanies` | List | Drop employers by name. |
| `skipReposts`, `withSalaryOnly`, `withContactOnly`, `workloadFullyInRange` | Boolean | Default `false`. |
| **➕ Extra data** | | |
| `includeDetails` | Boolean | The full job record (default `true`, no extra charge). |
| `includeCompanyDetails` | Boolean | Employer profile fields on each job. Default `false`. |
| `includeRatingBreakdown` | Boolean | Star counts and sub-ratings (salary, management, atmosphere, conditions). Default `false`. |
| `includeSalaryEstimate` | Boolean | The site's salary estimate (CHF a year) for the job's occupation and canton. Default `false`. |
| `translateTo` | Select | `en`, `de`, `fr`, `it` - the site's translation of title and ad. |
| `extractContacts` | Boolean | E-mails, phones, links and social profiles written in the ad. Default `true`. |
| `language` | Select | Language of links, labels and occupation names: `en` (default), `de`, `fr`. |
| **🔁 Monitoring** | | |
| `monitorMode` | Boolean | Only jobs earlier runs did not deliver. Pair with a schedule. |
| `monitorStoreName` | String | One name per scheduled search, e.g. `python-zurich`. |
| `firstRunMode` | Select | `emitAll` (default) or `seedOnly` (remember, deliver from the next run). |
| `emitUpdated`, `emitUnchanged`, `emitExpired` | Boolean | Also changed ads / every ad / ads taken offline. |
| `statsMode` | Select | `off`, `include`, `only` (free statistics rows). |
| **📦 Output** | | |
| `maxItems` | Integer | Default `50`; `0` = everything that matches. |
| `maxItemsPerSearch`, `maxPages` | Integer | Per-search caps. |
| `splitBeyondCap` | Boolean | Read past the site's 2,000 per search. Default `true`. |
| `descriptionFormat`, `descriptionMaxLength` | Select / Integer | `all`, `text`, `html`, `markdown`; cut length. |
| `compact`, `excludeEmptyFields` | Boolean | Core fields only (AI / MCP); drop empty fields. |
| **🔔 Alerts** | | Telegram, Slack, Discord, Teams, WhatsApp Cloud API, ntfy, webhook; `notificationLimit`. |
| **⚙️ Advanced** | | `maxConcurrency` (default 10), `proxyConfiguration` (not needed). |

#### Input JSON

```json
{
  "searchQueries": ["Pflege", "Informatik"],
  "cantons": ["ZH", "BE"],
  "employmentTypes": ["permanent"],
  "workloadMin": 80,
  "postedWithinDays": 7,
  "companyFilter": "exclude-hr",
  "sortBy": "date",
  "maxItems": 200
}
```

#### Put one idea per keyword

Each keyword is its own search on each site, and the run cap is shared evenly between searches. **Do:** `["Pflegefachfrau", "Pflegefachmann"]` · **Don't:** `["Pflegefachfrau Pflegefachmann Zürich"]` (the site matches all words in one ad and returns far fewer jobs; put the town in **Locations**).

#### Paste a search link when you already filtered on the site

Every filter in a jobs.ch / jobup.ch search link is kept: `https://www.jobs.ch/en/vacancies/?term=koch&location=Bern&employment-type=5` returns exactly that search. Category pages (`/en/vacancies/vehicles-craft-warehouse-transport/`) and a company's job list (`/en/companies/77923-gruner-ag/jobs/`) work too.

#### Company names: use the name as the site writes it

`companyNames: ["Migros"]` finds every company whose name has the word Migros (Migros Aare, Migros Zürich, Migros Bank ...), up to 25 per name. A name the site does not know returns nothing (never an unrelated company); paste the company link instead.

### ⬆️ Output

One row per job (or per company in company mode). A real row from the 1,000-job run (ad text shortened here):

```json
{
  "type": "job",
  "id": "b522eaad-8db8-4055-85d7-9e5e472f0d67",
  "site": "jobs.ch",
  "sites": ["jobs.ch"],
  "url": "https://www.jobs.ch/en/vacancies/detail/b522eaad-8db8-4055-85d7-9e5e472f0d67/",
  "title": "Entwicklungsingenieur/in für den Bereich Fahrzeugbau und Spezialprojekte (80-100%)",
  "synonym": "Engineer",
  "company": "Calag Carrosserie Langenthal AG",
  "companyId": "78171",
  "companyUrl": "https://www.jobs.ch/en/companies/78171-calag-carrosserie-langenthal-ag/",
  "companyType": "Large company",
  "isHrAgency": false,
  "place": "Langenthal",
  "street": "Chasseralstrasse 7",
  "zipcode": "4901",
  "city": "Langenthal",
  "canton": "BE",
  "cantonName": "Bern",
  "latitude": 47.2157,
  "longitude": 7.76541,
  "regions": ["German part of Switzerland", "Region of Bern", "Mittelland (AG / SO)"],
  "workload": "80-100%",
  "workloadMin": 80,
  "workloadMax": 100,
  "employmentTypes": ["Permanent position"],
  "positionLevel": "Specialist",
  "languageSkills": [{ "language": "de", "name": "German", "level": 3 }],
  "categories": ["Machine / Plant Engin. / Manufacturing", "Construction", "Vehicles / Craft / Warehouse / Transport", "Metal Crafts"],
  "industry": "Commercial operation / Skilled crafts",
  "easyApply": true,
  "description": "Möchtest Du Dein technisches Know-How in unserem Team einbringen und anspruchsvolle, massgeschneiderte Lösungen ... entwickeln und konstruieren? ...",
  "contactName": "Fabian Stuker",
  "contactTitle": "Leiter Technik",
  "contactPhone": "062 919 42 42",
  "contactEmail": "jobs@calag.ch",
  "applyEmail": "jobs@calag.ch",
  "applicationMethod": "form",
  "publicationDate": "2026-10-26T13:02:38.000Z",
  "initialPublicationDate": "2026-10-26T13:03:27.000Z",
  "publicationEndDate": "2026-11-26",
  "daysOld": 10,
  "salaryMin": null,
  "detailsIncluded": true,
  "isRepost": false,
  "scrapedAt": "2026-11-06T10:41:42.964Z"
}
```

Every row also carries `urlDe` / `urlFr` / `urlEn`, `summary`, `descriptionHtml`, `descriptionMarkdown`, `locations` (every workplace), `employmentGrades`, the id lists, `listingTags`, `isPaid`, `contacts`, `extractedEmails` / `extractedPhones` / `extractedUrls` / `socialProfiles` and `contentHash`. The options add `salaryEstimateMin` / `Max` / `Scope` / `SampleSize`, `translatedTitle` / `translatedDescription` / `originalLanguage`, and `companyWebsite`, `companyEmployeeCount`, `companyAddress`, `companyRating`, `companyRatingBreakdown` and more. The full field list with descriptions is in the **Output** tab.

The dataset has views for **Jobs**, **Details**, **Contacts**, **Companies** and **Monitor**.

### How much does it cost to scrape jobs.ch?

Pay per row, no start fee:

| What | Price |
|---|---|
| Job row (with the full job record) | **$0.45 per 1,000** ($0.00045 each) |
| Company row (company mode) | **$0.90 per 1,000** ($0.0009 each) |
| Salary estimate, translation, company profile on jobs, rating breakdown, statistics | included |

Examples from real runs: 20 jobs (the prefilled form) = $0.009; 150 jobs = $0.0675; 1,000 jobs = $0.45. The $5 of monthly credit in Apify's free plan covers about 11,000 jobs. Set **Maximum cost per run** in the run options and the run stops cleanly at that amount (a $0.02 limit delivered 44 jobs, 44 charged).

### Run it on a schedule (only new jobs)

1. Fill in the search and turn on **Only new jobs** (`monitorMode`) with a **Monitor name**, e.g. `pflege-zurich`.
2. Save it as a task and add a schedule (e.g. every morning at 7:00).
3. Each run reads only jobs first published since the last run and delivers only the ones not delivered before; a run with nothing new costs nothing in rows (measured: an empty poll used $0.0001 of platform usage). Turn on job details, company details, the rating breakdown, the salary estimate or a translation later and the jobs delivered without it come back once with it (`changeType: "details"`, read by their job id when they are older than the poll), charged like any delivered job.
4. Add a Telegram, Slack, Teams, Discord, WhatsApp or webhook alert to get the new jobs pushed to you.

```json
{
  "searchQueries": ["Pflegefachperson"],
  "locations": ["Zürich"],
  "monitorMode": true,
  "monitorStoreName": "pflege-zurich",
  "emitExpired": true,
  "maxItems": 200
}
```

Through the API: `POST https://api.apify.com/v2/acts/topapi~jobs-ch-scraper/runs?token=<YOUR_TOKEN>` with the input above as the body; through MCP, add the actor to your Apify MCP server.

### Speed and limits (measured 2026-11-06)

- 20 jobs: ~2 s · 150 jobs: 3-5 s · 1,000 jobs with full records: 103-117 s · 2,500 jobs with full records: ~10 minutes · all 5,865 "pflege" jobs (search cards only): 176 s.
- The sites limit how many requests one address may send (about 1,000 per 5 minutes). Big runs pace themselves under that and move to Apify proxy addresses when a site limits them, so a run of a few thousand jobs with full records takes minutes, not seconds. Search cards only (`includeDetails: false`) need 20x fewer requests (20 jobs per request): 5,865 jobs in 176 s.
- jobs.ch shows at most 2,000 jobs per search; with `splitBeyondCap` (default) a larger search is read in date windows.
- Fields are what the employer published: a contact person is on 28% of jobs, a published salary on 4% (the salary estimate option fills the gap).
- The salary estimate is the site's own figure for the occupation in the job's canton (or all of Switzerland when the canton has too few data), not the employer's offer; `salaryIsEstimate` says which you have.

### FAQ

**Does it cover jobup.ch?** Yes - both boards by default (`sites`). A job posted on both comes once with `sites: ["jobs.ch", "jobup.ch"]`.

**Can I get more than 2,000 jobs for one search?** Yes. The search is split by publication date behind the scenes; turn `splitBeyondCap` off to stop at 2,000.

**Which language are the ads in?** The language the employer wrote them in (mostly German on jobs.ch, French on jobup.ch). Set `translateTo` for the site's translation; `language` sets the language of links, labels and occupation names.

**How do I get only direct employers?** `companyFilter: "exclude-hr"` drops recruitment and staffing agencies; `only-hr` keeps only them.

**How do I search a canton?** `cantons: ["ZH"]`, or put the code in **Locations** (`"GE"`). Every job row has its `canton` when the ad gives an address.

**Can I scrape company profiles?** Yes: `mode: "companies"` with `companyNames`, `companyIds`, company links or keywords; empty = the company directory. `includeCompanyJobs` adds their open jobs.

**What does a job cost when the full record is off?** The same $0.00045 - the record is included in the price; turning it off only makes the run faster.

**Is anything charged for empty runs?** No. A search that matches nothing ends with a status that says so, and nothing is charged.

**Can I use it from Make, Zapier, n8n or Google Sheets?** Yes, through Apify's integrations or the API; the dataset exports to CSV, Excel and JSON.

**Is there a free trial?** Apify's free plan includes $5 of credit every month - about 11,000 jobs with this actor.

### Other TopApi job actors

- [Indeed Jobs Scraper](https://apify.com/topapi/indeed-jobs-scraper) - Indeed in every country.
- [XING Jobs Scraper](https://apify.com/topapi/xing-jobs-scraper) - jobs in Germany, Austria and Switzerland on XING.
- [Welcome to the Jungle Jobs Scraper](https://apify.com/topapi/welcome-to-the-jungle-jobs-scraper) - jobs and company profiles.
- [Naukrigulf Jobs Scraper](https://apify.com/topapi/naukrigulf-jobs-scraper) - Gulf jobs from Naukrigulf.

# Actor input Schema

## `mode` (type: `string`):

Jobs: one row per job ad. Companies: one row per employer profile (website, address, employees, rating, open jobs).

## `searchQueries` (type: `array`):

Job titles or keywords, one per line, e.g. "Pflege", "comptable", "data engineer". Each keyword is its own search. Empty = all jobs. In company mode: company names.

## `locations` (type: `array`):

Towns, postcodes or canton codes, e.g. "Zürich", "8001", "GE". Every keyword is searched in every location; empty = all of Switzerland.

## `cantons` (type: `array`):

Search these cantons (each one its own search, combined with every keyword). Empty = all cantons.

## `sites` (type: `array`):

Which board(s) to search. A job posted on both comes once, with both sites in "sites".

## `startUrls` (type: `array`):

jobs.ch / jobup.ch links: search pages (all their filters are kept), job pages, company pages or a company's job list, e.g. https://www.jobs.ch/en/vacancies/?term=koch\&location=Bern

## `jobIds` (type: `array`):

Job ids (the UUID in a job link), e.g. 98d92361-e172-4565-b413-5c4b521ec906. Each is read from jobs.ch, then jobup.ch.

## `companyNames` (type: `array`):

Employer names, e.g. "Migros", "Nestlé". Jobs mode: their open jobs. Company mode: their profiles.

## `companyIds` (type: `array`):

Company ids or slugs from a company link, e.g. 77923 or 77923-gruner-ag.

## `employmentTypes` (type: `array`):

Only jobs with these contract types. Empty = all.

## `positionLevels` (type: `array`):

Only jobs at these levels. Empty = all.

## `workloadMin` (type: `integer`):

Minimum workload (Pensum), e.g. 80. A job offered at 60-100% matches 80.

## `workloadMax` (type: `integer`):

Maximum workload (Pensum), e.g. 60 for part-time jobs. Empty = 100.

## `postedWithinDays` (type: `integer`):

Only jobs first published in the last N days, e.g. 1, 3, 7 or 30. Empty = any time.

## `postedAfter` (type: `string`):

Only jobs first published on or after this date (YYYY-MM-DD).

## `postedBefore` (type: `string`):

Only jobs first published on or before this date (YYYY-MM-DD).

## `categories` (type: `array`):

Job categories by name or id as the site lists them, e.g. "IT / Telecommunications", "Medicine / Care / Therapy", 106.

## `regions` (type: `array`):

Site regions by name or id, e.g. "Region of Basel", "Central Switzerland", "Canton of Geneva" (jobup.ch).

## `industries` (type: `array`):

Employer industries by name or id, e.g. "Information technology / Telecom.", "Banking / Financial institutions".

## `companyFilter` (type: `string`):

Keep or drop jobs posted by recruitment / staffing agencies (Adecco, Manpower, Hays ...).

## `companyTypes` (type: `array`):

Only jobs from these company types, as the site files them. Empty = all.

## `languageSkills` (type: `array`):

Only jobs that ask for one of these languages.

## `sortBy` (type: `string`):

Order of the results. Newest first is best for scheduled runs.

## `searchMode` (type: `string`):

Classic matches the keyword; semantic finds related wording. Both read every job's full record.

## `titleKeywords` (type: `array`):

Keep only jobs whose title contains one of these words, e.g. "senior", "lead".

## `excludeKeywords` (type: `array`):

Drop jobs whose title contains one of these words, e.g. "praktikum", "stage".

## `excludeCompanies` (type: `array`):

Drop jobs from employers whose name contains one of these, e.g. "adecco".

## `skipReposts` (type: `boolean`):

Drop a job when the same employer already has a job with the same title in this run (reposted ads).

## `withSalaryOnly` (type: `boolean`):

Keep only jobs with a published salary (or a salary estimate when that option is on).

## `withContactOnly` (type: `boolean`):

Keep only jobs with a contact e-mail, phone or application e-mail in the ad.

## `workloadFullyInRange` (type: `boolean`):

Keep only jobs whose whole workload range lies inside the workload filter (60-100% is dropped for 80-100%).

## `includeDetails` (type: `boolean`):

The ad text (text, HTML, Markdown), contact person and phone, apply link and e-mail, address, postcode, canton, skills. Off = search card fields only (faster).

## `includeCompanyDetails` (type: `boolean`):

Adds the employer's website, address, employees, turnover, founding year, open jobs, rating and social links to each job row.

## `includeRatingBreakdown` (type: `boolean`):

Adds the employer's star counts and sub-ratings (salary, management, atmosphere, conditions) to company data.

## `includeSalaryEstimate` (type: `boolean`):

Adds the site's salary estimate for the job's occupation (CHF a year, for its canton or all of Switzerland) and its sample size.

## `translateTo` (type: `string`):

Adds the site's own translation of the title and ad text, plus the ad's original language.

## `extractContacts` (type: `boolean`):

Adds the e-mails, phone numbers, links and social profiles written in the ad text.

## `includeCompanyJobs` (type: `boolean`):

Company mode: also deliver each company's open jobs as job rows.

## `language` (type: `string`):

Language of links, labels (categories, regions, contract types) and occupation names. Ads stay in the language they were written in.

## `monitorMode` (type: `boolean`):

Deliver only jobs that earlier runs with the same input did not deliver. Polls read jobs first published since the last run.

## `monitorStoreName` (type: `string`):

Named store that remembers delivered jobs. Use one name per scheduled search, e.g. "python-zurich".

## `firstRunMode` (type: `string`):

What the first monitor run does.

## `emitUpdated` (type: `boolean`):

Also deliver remembered jobs whose ad changed (changeType "updated").

## `emitUnchanged` (type: `boolean`):

Deliver every matching job each run, marked "new", "updated" or "unchanged".

## `emitExpired` (type: `boolean`):

Check remembered jobs not seen any more; a job taken offline comes as a row with changeType "expired" (charged as a job).

## `resetMonitor` (type: `boolean`):

Forget what earlier runs delivered for this input.

## `statsMode` (type: `string`):

Per search: total jobs and counts by region, category, industry, contract type, level, company type, workload, language and town.

## `maxItems` (type: `integer`):

Most rows this run delivers (jobs or companies). 0 = everything that matches. The sites show 2,000 jobs per search; past that the search is split by date.

## `maxItemsPerSearch` (type: `integer`):

Most rows per keyword x location x site. Empty = the run cap shared evenly.

## `maxPages` (type: `integer`):

Most search pages (20 jobs each) read per search. Empty = as many as needed.

## `splitBeyondCap` (type: `boolean`):

A search with more than 2,000 matches is read window by window (publication date), so nothing is cut off.

## `descriptionFormat` (type: `string`):

Which forms of the ad text each row carries.

## `descriptionMaxLength` (type: `integer`):

Cut the ad text after this many characters. Empty = full text.

## `compact` (type: `boolean`):

Core fields only (no HTML/Markdown copies, id lists or media) - trimmed for AI / MCP pipelines.

## `excludeEmptyFields` (type: `boolean`):

Leave out fields that are empty on a row.

## `telegramToken` (type: `string`):

Your bot token from @BotFather.

## `telegramChatId` (type: `string`):

The chat or channel id the bot posts to.

## `slackWebhookUrl` (type: `string`):

A Slack incoming-webhook URL.

## `discordWebhookUrl` (type: `string`):

A Discord channel webhook URL.

## `teamsWebhookUrl` (type: `string`):

A Microsoft Teams incoming-webhook URL.

## `whatsappAccessToken` (type: `string`):

WhatsApp Cloud API access token (your Meta app).

## `whatsappPhoneNumberId` (type: `string`):

WhatsApp Cloud API phone number id that sends the message.

## `whatsappTo` (type: `string`):

Recipient number with country code, e.g. 41791234567.

## `ntfyTopic` (type: `string`):

Push to an ntfy.sh topic (or your own server below).

## `ntfyServer` (type: `string`):

Your ntfy server, e.g. https://ntfy.example.com. Empty = ntfy.sh.

## `webhookUrl` (type: `string`):

Receives a JSON POST with the new jobs.

## `webhookHeaders` (type: `object`):

Extra headers for the webhook, e.g. {"Authorization": "Bearer ..."}.

## `notificationLimit` (type: `integer`):

How many jobs the alert lists (the count covers all).

## `maxConcurrency` (type: `integer`):

Job records read at once.

## `proxyConfiguration` (type: `object`):

Not needed: the actor reads the sites directly and moves to Apify proxy on its own when a site limits a run. Set one only to force your own.

## Actor input object example

```json
{
  "mode": "jobs",
  "searchQueries": [
    "python"
  ],
  "sites": [
    "jobs.ch",
    "jobup.ch"
  ],
  "companyFilter": "all",
  "sortBy": "relevance",
  "searchMode": "classic",
  "skipReposts": false,
  "withSalaryOnly": false,
  "withContactOnly": false,
  "workloadFullyInRange": false,
  "includeDetails": true,
  "includeCompanyDetails": false,
  "includeRatingBreakdown": false,
  "includeSalaryEstimate": false,
  "translateTo": "",
  "extractContacts": true,
  "includeCompanyJobs": false,
  "language": "en",
  "monitorMode": false,
  "monitorStoreName": "jobs-ch-monitor",
  "firstRunMode": "emitAll",
  "emitUpdated": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "resetMonitor": false,
  "statsMode": "off",
  "maxItems": 20,
  "splitBeyondCap": true,
  "descriptionFormat": "all",
  "compact": false,
  "excludeEmptyFields": false,
  "notificationLimit": 10,
  "maxConcurrency": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `results` (type: `string`):

One item per job (or company, or search-statistics row): title, employer, place, canton, workload, contract type, level, categories, dates, salary, the full ad, contact, apply link.

## `summary` (type: `string`):

Per-search counts (on the site, read, delivered), filters, egress and requests (written for Console runs, large runs and runs with a problem).

## `stats` (type: `string`):

With search statistics on: totals and counts by region, category, industry, contract type, level, company type, workload and town per search.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "python"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("topapi/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["python"],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("topapi/jobs-ch-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "python"
  ],
  "maxItems": 20
}' |
apify call topapi/jobs-ch-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,topapi/jobs-ch-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/hUz9Xo3ek9z7SSlCa/builds/7PPEEtvb2ay8z7aGE/openapi.json
