# Job Room Jobs Details Scraper (`soft_alexist/job-room-jobs-details-scraper`) Actor

Scrape detailed job postings from Job-Room.ch with structured data extraction. Collect job descriptions, company info, locations, occupations, language requirements, and employment details from Switzerland's official job platform — essential for recruiters, job aggregators, and labor researchers.

- **URL**: https://apify.com/soft_alexist/job-room-jobs-details-scraper.md
- **Developed by:** [Soft Alexist](https://apify.com/soft_alexist) (community)
- **Categories:** Automation, Developer tools, Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

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

## Job-Room.ch Jobs Scraper: Extract Swiss Job Details Instantly

***

### What Is Job-Room.ch?

Job-Room.ch is Switzerland's official public employment service platform, operated by the State Secretariat for Economic Affairs (SECO). It aggregates thousands of job openings across all Swiss sectors and language regions (German, French, Italian). With mandatory listings from many Swiss employers, it represents the most comprehensive and authoritative source for Swiss labor market data. Manually extracting structured information from these listings is tedious — the **Job-Room.ch Jobs Scraper** automates this workflow, delivering complete job records in seconds.

***

### Overview

The **Job-Room.ch Jobs Scraper** extracts structured job detail pages from Job-Room.ch, transforming raw HTML listings into clean, machine-readable records. It is ideal for:

- **Swiss recruiters** researching competitive salary ranges and job descriptions
- **HR professionals** building talent pipeline databases
- **Job aggregators** syndicating Swiss job postings to third-party platforms
- **Labor economists** analyzing employment trends across regions and sectors
- **Multilingual companies** tracking opportunities across German, French, and Italian Switzerland

Key features include flexible URL input, graceful error handling, and comprehensive data extraction across 10+ essential fields.

***

### Input Format

The scraper accepts a minimal JSON configuration:

```json
{
  "urls": [
    "https://www.job-room.ch/job-search/9f403e16-081a-478f-ab35-390e20f536c9"
  ],
  "ignore_url_failures": true
}
```

#### Configuration Parameters

| Parameter | Type | Description |
|---|---|---|
| `urls` | Array of strings | Direct links to specific Job-Room.ch job detail pages. Copy URLs from the browser address bar when viewing individual job postings. |
| `ignore_url_failures` | Boolean | If `true`, the scraper continues running even if some URLs fail to load or return errors. If `false`, the entire run stops on first error. Recommended: `true` for bulk scrapes. |

#### URL Format

- **Valid:** `https://www.job-room.ch/job-search/[UUID]`
- **Example:** `https://www.job-room.ch/job-search/9f403e16-081a-478f-ab35-390e20f536c9`
- **Note:** Use job *detail* URLs, not search result pages. Each URL must be a complete, public-facing posting link.

> **Tip:** Use the Bulk edit feature to paste multiple URLs at once. Each URL triggers one scrape operation.

***

### Output Format

**Sample output**

```json
{
  "external_url": "https://www.ipersonal.ch/jobs/baumaschinenmechaniker-bahntechnik-100-fuer-die-region-zollikon-gesucht/",
  "number_of_jobs": "1",
  "job_descriptions": [
    {
      "language_iso_code": "de",
      "title": "Baumaschinenmechaniker Bahntechnik 100% für die Region Zollikon gesucht",
      "description": "Du wirst als **Baumaschinenmechaniker Bahntechnik** in **Zollikon** gesucht und kannst gleich anfangen, denn ein Betrieb dort braucht dich sofort in einer festen Anstellung mit vollem Pensum. iPersonal vermittelt dir diese Stelle und begleitet dich dabei persönlich durch den ganzen Weg, deshalb bist du bei uns in guten Händen.\n\nZollikon liegt idyllisch am rechten Seeufer des Zürichsees und besticht durch seine exquisite Wohnlage mit herrlichem Seepanorama. Die Gemeinde ist hervorragend mit dem öffentlichen Verkehr erreichbar und verfügt über ausgezeichnete Autobahnanbindungen. Sie profitieren von der Nähe zu Zürich, den grünen Erholungsgebieten und dem gehobenen Infrastrukturangebot, das Zollikon zu einem begehrten Arbeits- und Wohnort macht.\n\n### Kurz zusammengefasst: Baumaschinenmechaniker Bahntechnik in Zollikon\n\n**Arbeitsort**   \nZollikon und Umgebung\n\n**Pensum**   \n100 %\n\n**Anstellungsart**   \nFestanstellung\n\n**Einsatzbeginn**   \nSofort oder nach Vereinbarung\n\n### Ihr Aufgabengebiet als Baumaschinenmechaniker Bahntechnik in Zollikon\n\n* Die Arbeit ist vielseitig und spannend. Zudem übernehmen Sie im Team jeden Tag diese Aufgaben:\n\n<!-- -->\n\n* Zunächst reparieren und warten Sie Maschinen sowie Fahrzeuge der Bahntechnik\n* Ausserdem übernehmen Sie Montagearbeiten an Spezialmaschinen\n* Darüber hinaus diagnostizieren Sie Störungen an Hydraulik, Pneumatik und Mechanik\n* Ebenso sind Sie mobil im Einsatz auf verschiedenen Baustellen\n* Schliesslich dokumentieren Sie Ihre Arbeiten sauber\n\n### Das setzen wir für diese Stelle voraus\n\n* Für diese Stelle als Baumaschinenmechaniker Bahntechnik in Zollikon gelten klare Anforderungen. Bewerben Sie sich daher nur, wenn Sie diese Punkte wirklich erfüllen:\n\n<!-- -->\n\n* Zunächst zwingend ein EFZ als Baumaschinenmechaniker, Landmaschinenmechaniker, Lastwagenmechaniker oder eine vergleichbare technische Ausbildung\n* Ausserdem zwingend Erfahrung in Reparatur, Wartung und Montage von Maschinen und Fahrzeugen\n* Darüber hinaus sind gute Kenntnisse in Hydraulik, Pneumatik und Mechanik von Vorteil\n* Zudem zwingend Mobilität für wechselnde Einsatzorte\n* Schliesslich zwingend Deutschkenntnisse in Wort und Schrift\n\n### iPersonal in Zollikon: Ihre Pluspunkte\n\n* Als Vermittler kennen wir den Arbeitsmarkt in Zollikon sehr gut. Deshalb finden wir rasch die passende Stelle und begleiten Sie dabei persönlich:\n\n<!-- -->\n\n* Zunächst einen fairen Lohn nach Tarif, weil gute Arbeit fair bezahlt gehört\n* Ausserdem Kurse und Weiterbildung über Temptraining\n* Darüber hinaus eine langfristige Stelle mit Perspektive\n* Zudem persönliche Betreuung von der Bewerbung bis zum ersten Arbeitstag\n* Schliesslich ein familiäres Klima sowie ein starkes Team\n\n### Jetzt bewerben als Baumaschinenmechaniker Bahntechnik in Zollikon\n\n* Senden Sie uns daher Ihren Lebenslauf mit Zeugnissen, denn wir melden uns innert 24 Stunden. Ausserdem finden Sie alle offenen Stellen bei iPersonal auf unserer Webseite. Oder Sie melden sich direkt mit einer Spontanbewerbung.\n\n### Häufige Fragen zur Stelle als Baumaschinenmechaniker Bahntechnik in Zollikon\n\n* **Ist die Stelle temporär oder fest?**\n* Es handelt sich um eine direkte Festanstellung beim Betrieb. Somit haben Sie von Beginn an Sicherheit und Perspektive.\n\n<!-- -->\n\n* **Wie schnell kann ich starten?**\n* Meist ab sofort, denn wir richten uns flexibel nach Ihnen.\n\n<!-- -->\n\n* **Wie bewerbe ich mich?**\n* Senden Sie uns einfach Ihre Unterlagen per E-Mail oder über die Webseite. Danach melden wir uns rasch und diskret bei Ihnen.\n\nDer Arbeitsmarkt für Baumaschinenmechaniker Bahntechnik in Zollikon zeigt eine konstant hohe Nachfrage nach qualifizierten Fachkräften, da die Infrastrukturprojekte in der Region kontinuierlich wachsen. iPersonal unterstützt Sie dabei, schnell und unkompliziert in diese zukunftssichere Branche einzusteigen, indem das Unternehmen gezielt Positionen bei etablierten Arbeitgebern vermittelt und Sie von Anfang an fachlich begleitet. Sie profitieren von einem großen Netzwerk von Arbeitgebern und flexiblen Einsatzmöglichkeiten, die Ihnen ermöglichen, Ihre Karriere aktiv zu gestalten.\n\n### Interessiert? Wir freuen uns auf Sie\n\n* Bewerben Sie sich deshalb jetzt als Baumaschinenmechaniker Bahntechnik für Zollikon. Ausserdem vermittelt iPersonal schnell und persönlich, denn gute Fachkräfte verdienen ebenso gute Partner.\n\n**Per E-Mail**   \nml@ipersonal.ch\n\n**Offene Stellen**   \nwww.ipersonal.ch/offene-stellen/\n\n**Spontanbewerbung**   \nwww.ipersonal.ch/lebenslauf-hochladen/\n\n* **Ihr iPersonal Personalexperten-Team**\n* iPersonal AG · Bahnhofplatz 1C · 8304 Wallisellen\n* Telefon: 044 515 57 56 · E-Mail: ml@ipersonal.ch\n* **iPersonal -- Ihr Partner für Temporär und Dauerstellenvermittlung**\n"
    }
  ],
  "company": {
    "name": "iPersonal AG",
    "street": "Bahnhofplatz",
    "house_number": "1c",
    "postal_code": "8304",
    "city": "Wallisellen",
    "country_iso_code": "CH",
    "post_office_box_number": null,
    "post_office_box_postal_code": null,
    "post_office_box_city": null,
    "phone": "+41445155756",
    "email": "info@ipersonal.ch",
    "website": "ipersonal.ch",
    "surrogate": true
  },
  "employment": {
    "start_date": null,
    "end_date": null,
    "short_employment": false,
    "immediately": true,
    "permanent": true,
    "workload_percentage_min": "100",
    "workload_percentage_max": "100",
    "work_forms": []
  },
  "location": {
    "id": null,
    "remarks": null,
    "city": "Zollikon",
    "postal_code": "8702",
    "communal_code": "161",
    "region_code": "ZH04",
    "canton_code": "ZH",
    "country_iso_code": "CH",
    "coordinates": {
      "lon": "8.574",
      "lat": "47.338"
    }
  },
  "occupations": [
    {
      "avam_occupation_code": "102073",
      "work_experience": null,
      "education_code": null,
      "qualification_code": null
    }
  ],
  "language_skills": [
    {
      "language_iso_code": "de",
      "spoken_level": "BASIC",
      "written_level": "BASIC"
    }
  ],
  "apply_channel": {
    "raw_post_address": null,
    "post_address": null,
    "email_address": "info@ipersonal.ch",
    "phone_number": "+41445155756",
    "form_url": "https://www.ipersonal.ch/jobs/baumaschinenmechaniker-bahntechnik-100-fuer-die-region-zollikon-gesucht/",
    "additional_info": null
  },
  "public_contact": {
    "salutation": "MR",
    "first_name": "Massimo",
    "last_name": "Lovizio",
    "phone": "+41445155756",
    "email": "ml@ipersonal.ch"
  }
}
```

Each scraped job returns a structured record with 10 key fields:

#### Core Job Information

| Field | Meaning | Example |
|---|---|---|
| `External URL` | Direct link to the job posting on Job-Room.ch | `https://www.job-room.ch/job-search/9f403e16...` |
| `Job Descriptions` | Full HTML job description and responsibilities | "Manage team of 5 engineers, lead product roadmap..." |
| `Number Of Jobs` | Number of open positions for this listing | `3` or `1` |
| `Employment` | Contract type and employment terms | "Full-time, permanent" or "100%, temporaire 6 mois" |

#### Employer & Location

| Field | Meaning | Example |
|---|---|---|
| `Company` | Official employer name as registered on Job-Room.ch | "Acme AG" or "Bureau de l'emploi Genève" |
| `Location` | Job location(s) including canton and municipality | "Zurich (ZH)" or "Geneva (GE), Lausanne (VD)" |
| `Public Contact` | Publicly listed employer contact info (name, email, phone) | "John Doe, recruiter@acme.ch, +41 44 123 4567" |

#### Job Attributes

| Field | Meaning | Example |
|---|---|---|
| `Occupations` | Job classification(s) per Swiss occupation taxonomy | "Software Engineer", "Électricien-ne" |
| `Language Skills` | Required languages and proficiency levels | "German (B2), French (B1), English (A2)" |
| `Apply Channel` | How to apply (direct, email, external site) | "Via Job-Room.ch platform" or "Email: hr@example.ch" |

#### Data Structure & Quality

- **HTML preservation:** Descriptions are extracted as raw HTML to preserve formatting; strip tags if plain text is preferred.
- **Multilingual content:** Language fields may include multiple entries (e.g., postings in German, French, and Italian).
- **Contact info:** Public Contact is available only if the employer chose to display it; some postings may be empty.
- **Canton codes:** Locations use standard Swiss canton abbreviations (ZH, BE, GE, VD, VS, etc.).

***

### How to Use

1. **Find job URLs** — Log into Job-Room.ch (or browse without login) and open individual job postings. Each job has a unique detail page URL.

2. **Copy URLs** — Click the job title to open the detail page, then copy the full URL from your browser's address bar.

3. **Paste into scraper** — In the actor input, paste URLs into the `urls` array:

```json
   {
     "urls": [
       "https://www.job-room.ch/job-search/UUID-1",
       "https://www.job-room.ch/job-search/UUID-2"
     ],
     "ignore_url_failures": true
   }
```

4. **Run the scraper** — Click Start and monitor progress. The actor logs each URL and any errors encountered.

5. **Download results** — Export as JSON (structured records) or CSV (flat table) from the Results tab.

**Common troubleshooting:**

- **No data returned:** Verify the URL is a job detail page (contains `job-search/UUID`), not a search results page.
- **URL failures:** If `ignore_url_failures: false`, a single broken link halts the entire run. Set to `true` for robustness.
- **Contact info missing:** Some employers hide contact details; Public Contact field will be empty.

***

### Use Cases & Business Value

- **Recruitment analytics:** Track salary trends, in-demand skills, and hiring patterns across Swiss regions
- **Job aggregation:** Syndicate Job-Room listings to niche job boards or internal HR systems
- **Competitive intelligence:** Monitor how competitors position roles and describe requirements
- **Labor market research:** Analyze employment growth by sector, location, and language region
- **Talent sourcing:** Build spreadsheets of target companies and their active openings

The Job-Room.ch scraper delivers Swiss employment data in a format ready for analysis, reporting, or integration with downstream platforms.

***

### Conclusion

The **Job-Room.ch Jobs Scraper** is an efficient, reliable tool for extracting structured job data from Switzerland's official employment service. With simple configuration, robust error handling, and comprehensive output fields, it eliminates manual data entry and enables large-scale labor market insights. Start scraping today and turn Job-Room postings into actionable business intelligence.

# Actor input Schema

## `urls` (type: `array`):

Add the URLs of the Specific jobs urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.

## `ignore_url_failures` (type: `boolean`):

If true, the scraper will continue running even if some URLs fail to be scraped.

## Actor input object example

```json
{
  "urls": [
    "https://www.job-room.ch/job-search/9f403e16-081a-478f-ab35-390e20f536c9"
  ],
  "ignore_url_failures": true
}
```

# 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 = {
    "urls": [
        "https://www.job-room.ch/job-search/9f403e16-081a-478f-ab35-390e20f536c9"
    ],
    "ignore_url_failures": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("soft_alexist/job-room-jobs-details-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 = {
    "urls": ["https://www.job-room.ch/job-search/9f403e16-081a-478f-ab35-390e20f536c9"],
    "ignore_url_failures": True,
}

# Run the Actor and wait for it to finish
run = client.actor("soft_alexist/job-room-jobs-details-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 '{
  "urls": [
    "https://www.job-room.ch/job-search/9f403e16-081a-478f-ab35-390e20f536c9"
  ],
  "ignore_url_failures": true
}' |
apify call soft_alexist/job-room-jobs-details-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,soft_alexist/job-room-jobs-details-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/I8Jb3RgWWqhedRa79/builds/uWQRpV8PGXmAVUGiE/openapi.json