# jobs.ch Jobs Scraper — Swiss Job Listings & Salaries (`ocrad/jobsch-jobs-scraper`) Actor

Scrape jobs.ch Swiss job listings from any search URL (English, German or French): title, company, location, workload, contract type, posting date and, with detailedInfo, full description, salary estimate, closing date and apply link. Export JSON/CSV/Excel.

- **URL**: https://apify.com/ocrad/jobsch-jobs-scraper.md
- **Developed by:** [Ocrad](https://apify.com/ocrad) (community)
- **Categories:** Jobs, Lead generation, Agents
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 records

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

### jobs.ch Jobs Scraper

***

Swiss Job Listings. Provide any jobs.ch search URL, in English (`/en/vacancies/`), German (`/de/stellenangebote/`) or French (`/fr/offres-emplois/`), and get structured job data across result pages: title, employer, location with postal code and canton, workload percentage, contract type, position level, required languages, posting dates, company profile and the job page. Turn on `detailedInfo` to also get the full description (original text plus jobs.ch's translation), jobs.ch's salary estimate, apply link, application method, closing date, weekly working hours, category and the employer website from each job page.

jobs.ch is one of Switzerland's largest job boards (Zürich, Geneva, Basel, Bern, Lausanne …). The search URL language decides the labels (e.g. `Permanent position` / `Festanstellung`) and the job links in the output.

***

#### **📋 Example Output**

Record from a run with `detailedInfo: true` on `https://www.jobs.ch/en/vacancies/?term=data%20analyst` (description shortened here). Without `detailedInfo`, the detail-only fields `salary*`, `contractStart`, `validThrough`, `workHours`, `category`, `description`, `descriptionTranslated`, `applyUrl`, `applicationMethod`, `companyWebsite` and `language` are `null`:

```json
{
  "id": "425e7e14-05eb-4068-bcfb-89726525f38f",
  "url": "https://www.jobs.ch/en/vacancies/detail/425e7e14-05eb-4068-bcfb-89726525f38f/",
  "title": "Principal Data and AI Consultant",
  "company": "Zühlke Engineering AG",
  "companyId": "8781802e-c676-4212-b824-285efef25731",
  "companyUrl": "https://www.jobs.ch/en/companies/8781802e-c676-4212-b824-285efef25731-zuehlke-engineering-ag/",
  "location": "Schlieren",
  "street": "Zürcherstrasse 39j",
  "postalCode": "8952",
  "canton": "ZH",
  "countryCode": "CH",
  "latitude": 47.39916,
  "longitude": 8.45341,
  "workload": "80-100%",
  "workloadMin": 80,
  "workloadMax": 100,
  "employmentType": "Permanent position",
  "position": "Specialist",
  "languageSkills": "de (Intermediate)",
  "postedAt": "2026-10-13T10:07:40+02:00",
  "initialPostedAt": "2026-10-13T08:07:40+00:00",
  "isNew": false,
  "logoUrl": null,
  "salary": "CHF 100'000 - 140'000 / year (jobs.ch estimate)",
  "salaryMin": 100000,
  "salaryMax": 140000,
  "salaryCurrency": "CHF",
  "salaryPeriod": "year",
  "contractStart": null,
  "validThrough": "2026-11-28",
  "workHours": "33.6 - 42 hours/week",
  "category": "Technical / Information Technology / Telecom. / Consultancy / Business Informatics",
  "description": "Founded in Switzerland in 1968, Zühlke is owned by its partners and located across Europe and Asia. We are a global transformation partner, with engineering and innovation in our DNA. We're trusted to help clients envision and build their businesses for the future – to run smarter today while adapting for tomorrow’s markets, customers, and communities. Our multidisciplinary teams specialise in tech strategy and business innovation, digital solutions and applications, and device and systems engineering. We excel in complex, regulated spaces including health and finance, connecting strategy, tech implementation, and operational services to help clients become more effective, resilient …",
  "descriptionTranslated": null,
  "applyUrl": "https://zuehlke.wd3.myworkdayjobs.com/en-US/Zuhlke-Careers/job/Principal-Data-Consultant_JR100670",
  "applicationMethod": "external",
  "companyWebsite": "https://www.zuehlke.com/de/karriere",
  "language": "en",
  "scrapedAt": "2026-11-03T17:05:25.499Z"
}
```

`salary` is the **salary estimate jobs.ch shows on the job page** (calculated by jobs.ch for a 100% workload, not provided by the employer). `description` is the ad in its original language (`language`); when that differs from the search URL language, `descriptionTranslated` holds jobs.ch's translation. `applyUrl` is the employer's application link for `applicationMethod: "external"`, and the jobs.ch job page when applications go through the jobs.ch form (`"form"`). `contractStart` is filled only when the ad states a start date.

#### ⚙️ **Configuration**

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `url` | String | *(required)* | jobs.ch search URL with your filters: English (`https://www.jobs.ch/en/vacancies/?term=engineer`), German (`https://www.jobs.ch/de/stellenangebote/?term=buchhalter&location=Z%C3%BCrich`) or French (`https://www.jobs.ch/fr/offres-emplois/?term=comptable`). A `&page=N` parameter is honoured as the starting page. |
| `maxItems` | Integer | `100` | Stop after this many jobs (about 20 per result page, pages are fetched until the limit or the last page). 0 = no limit. |
| `detailedInfo` | Boolean | `false` | Visit each job page for the full description, salary estimate, apply link, closing date, working hours, category and company website. One extra request per job. |
| `proxyConfiguration` | Object | Apify Proxy (auto) | Proxy settings; switch to RESIDENTIAL only if results are empty. |

##### Example Input

```json
{
  "url": "https://www.jobs.ch/en/vacancies/?term=data%20analyst",
  "maxItems": 100,
  "detailedInfo": true
}
```

##### Getting your search URL

1. Open jobs.ch in your language, enter a keyword and a location, and apply filters (workload, contract type, region, category …)
2. Copy the full URL from your browser address bar
3. Paste it as the `url` input

***

#### 💬 **Support and Feedback**

Reach out via Apify support channels or leave feedback on the Actor's page.

#### **Is it legal to scrape jobs.ch data?**

It is legal to scrape publicly available data such as job titles, employers, locations and descriptions. Results may contain personal data (e.g. names of contacts inside a posting); scrape personal data only with a legitimate reason. Personal data is protected by the Swiss Federal Act on Data Protection (FADP), the GDPR and other regulations — consult your legal advisor if unsure.

# Actor input Schema

## `url` (type: `string`):

A jobs.ch search results URL in English (https://www.jobs.ch/en/vacancies/?term=engineer), German (https://www.jobs.ch/de/stellenangebote/?term=buchhalter\&location=Z%C3%BCrich) or French (https://www.jobs.ch/fr/offres-emplois/?term=comptable). All filters in the URL are kept; a \&page=N parameter is honoured as the starting page.

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

Stop after this many jobs (about 20 per result page). 0 = no limit.

## `detailedInfo` (type: `boolean`):

Visit each job page for the full description (original + jobs.ch translation), jobs.ch salary estimate, apply link, closing date, working hours, category and company website. Slower, one extra request per job.

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

Proxy settings. Defaults to Apify Proxy (auto). Switch to RESIDENTIAL only if results are empty.

## Actor input object example

```json
{
  "url": "https://www.jobs.ch/en/vacancies/?term=engineer",
  "maxItems": 50,
  "detailedInfo": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `id` (type: `string`):

jobs.ch job ID (UUID)

## `url` (type: `string`):

Job page on jobs.ch

## `title` (type: `string`):

Job title

## `company` (type: `string`):

Employer name

## `companyId` (type: `string`):

jobs.ch company ID

## `companyUrl` (type: `string`):

Company profile on jobs.ch

## `location` (type: `string`):

Job location (place)

## `street` (type: `string`):

Street address

## `postalCode` (type: `string`):

Swiss postal code

## `canton` (type: `string`):

Canton code (e.g. ZH)

## `countryCode` (type: `string`):

Country code

## `latitude` (type: `string`):

Latitude

## `longitude` (type: `string`):

Longitude

## `workload` (type: `string`):

Workload / percentage (e.g. 80-100%)

## `workloadMin` (type: `string`):

Minimum workload in %

## `workloadMax` (type: `string`):

Maximum workload in %

## `employmentType` (type: `string`):

Contract type (e.g. Permanent position, Temporary)

## `position` (type: `string`):

Position level (Executive / Specialist / Employee)

## `languageSkills` (type: `string`):

Required languages and levels

## `postedAt` (type: `string`):

Publication date (ISO)

## `initialPostedAt` (type: `string`):

First publication date (ISO)

## `isNew` (type: `string`):

Marked as new by jobs.ch

## `logoUrl` (type: `string`):

Company logo URL

## `salary` (type: `string`):

jobs.ch salary estimate as text (detailedInfo)

## `salaryMin` (type: `string`):

Salary estimate minimum (detailedInfo)

## `salaryMax` (type: `string`):

Salary estimate maximum (detailedInfo)

## `salaryCurrency` (type: `string`):

Salary currency

## `salaryPeriod` (type: `string`):

Salary period (year)

## `contractStart` (type: `string`):

Employment start, when the ad gives one (detailedInfo)

## `validThrough` (type: `string`):

Publication end date (detailedInfo)

## `workHours` (type: `string`):

Working hours per week (detailedInfo)

## `category` (type: `string`):

Occupational category (detailedInfo)

## `description` (type: `string`):

Full job description text in its original language (detailedInfo)

## `descriptionTranslated` (type: `string`):

jobs.ch translation of the description into the page language, when the original is in another language (detailedInfo)

## `applyUrl` (type: `string`):

Application link (detailedInfo)

## `applicationMethod` (type: `string`):

Application method: external or form (detailedInfo)

## `companyWebsite` (type: `string`):

Employer website (detailedInfo)

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

Original language of the ad (detailedInfo)

## `scrapedAt` (type: `string`):

ISO 8601 timestamp when the record was scraped

# 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 = {
    "url": "https://www.jobs.ch/en/vacancies/?term=engineer",
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("ocrad/jobsch-jobs-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 = {
    "url": "https://www.jobs.ch/en/vacancies/?term=engineer",
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("ocrad/jobsch-jobs-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 '{
  "url": "https://www.jobs.ch/en/vacancies/?term=engineer",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call ocrad/jobsch-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,ocrad/jobsch-jobs-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/iKpO9SoaO41X3XxkA/builds/lV5rNDXoVBnmCe86W/openapi.json