# Jobbasel Jobs Details Scraper (`alexist/jobbasel-jobs-details-scraper`) Actor
Scrape detailed job postings from JobBasel.ch with precision. This scraper extracts 28+ fields including titles, company details, location data, dates, application URLs, and employment types — essential for recruiters, HR professionals, and Swiss labor market researchers.
- **URL**: https://apify.com/alexist/jobbasel-jobs-details-scraper.md
- **Developed by:** [Alex](https://apify.com/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/platform/actors/running/actors-in-store#pay-per-usage
## 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/docs.md):
```bash
npm install apify-client
```
In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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
## JobBasel Jobs Scraper: Harvest Swiss Job Listings Effortlessly
---
### What Is JobBasel.ch?
JobBasel.ch is Switzerland's dedicated job portal specializing in regional and national employment opportunities across diverse industries. Hosting thousands of active listings, it serves as a primary resource for job seekers and employers in the Basel region and beyond. Manually extracting and organizing this job data is labor-intensive — the **JobBasel Jobs Scraper** automates the entire process, delivering structured records ready for analysis and integration.
---
### Overview
The **JobBasel Jobs Details Scraper** extracts comprehensive job posting data from JobBasel.ch, transforming unstructured web content into clean, machine-readable records. It is designed for:
- **Swiss recruiters and staffing agencies** tracking local job market trends
- **HR professionals** conducting competitive salary and positioning analysis
- **Job aggregator platforms** integrating Swiss employment data
- **Labor market researchers** studying employment patterns and industry demands
- **Career analysts** benchmarking roles across sectors and locations
Key strengths include flexibility in URL targeting, robust error handling via `ignore_url_failures`, and comprehensive field extraction covering 28+ job attributes.
---
### Input Format
The scraper accepts a minimal yet powerful JSON configuration:
```json
{
"urls": [
"https://www.jobbasel.com/job/business-development-executive-127109153"
],
"ignore_url_failures": true
}
````
| Parameter | Type | Description |
|---|---|---|
| `urls` | Array | Individual JobBasel job detail page URLs. Paste one or multiple job links; avoid search results pages. |
| `ignore_url_failures` | Boolean | If `true`, the scraper continues if specific URLs fail, preventing interruptions during large batch runs. Default: `true`. |
**Example URL format:**\
`https://www.jobbasel.com/job/[job-title]-[job-id]`
> **Tip:** For batch scraping, use the bulk edit feature to paste a prepared list of job URLs from your research or saved links.
***
### Output Format
**Sample output**
```json
{
"id": 228188,
"title": "Köchin / Koch:",
"company_id": 26824,
"workplace_zip": "",
"workplace_city": "Basel",
"activity": "- Unterstützung des Küchenteams in einem dynamischen, klein strukturierten Betrieb mit zwei Outlets.
- Sicherstellung eines reibungslosen Produktions- und Serviceablaufs durch operative Exzellenz, Flexibilität und aktive Mitarbeit an der Front.
- Mitarbeit in beiden Outlets (Flavour Kitchen & Science Lounge)
- Produktion und Mise en Place gemäss Tagesangebot und Konzeptvorgaben im jeweiligen Outlet.
- Sicherstellung eines reibungslosen Ablaufs während der Servicezeiten (Fokus Mittagsgeschäft)
- Aktive Mitarbeit an der Front (Essensausgabe, Kasse, Kaffeestation)
- Mitarbeiten bei Caterings, Apéros und Spezialanlässen
- Eigenverantwortliches Führen eines Postens inkl. Organisation und PriorisierungSicherstellung und Pflege der Gäste- und Mitarbeiterzufriedenheit
- Sicherstellung des Serviceablaufs inkl. Mitarbeit an der Front
- Sicherstellung des Warenflusses (Nachschub, Warenannahme, Lagerbewirtschaftung)
- Aktives Mitdenken im Tagesgeschäft (z. B. Mengensteuerung, Vermeidung von Food Waste)
- Einbringen von Ideen zur Angebotsgestaltung und Optimierung von Abläufen
- Sicherstellung von Sauberkeit, Ordnung und Hygiene (HACCP)
- Umsetzung der ZFV-Qualitäts- und Nachhaltigkeitsstandards
- Flexible Unterstützung in allen Bereichen (Küche, Office, Front) je nach Bedarf
",
"requirements": "- Abgeschlossene Berufsausbildung als Köchin / Koch: EFZ Mindestens 3 Jahre Berufserfahrung als Köchin / Koch: Erfahrung in der Systemgastronomie oder Gemeinschaftsgastronomie von Vorteil Erfahrung im Catering- und Eventbereich wünschenswert Gute mündliche und schriftliche Deutschkenntnisse (mind. B2) Füherausweis Kat. B von Vorteil Grundkenntnisse in Kassensystemen von Vorteil Affinität für Kaffeespezialitätenzubereitung oder Bereitschaft dazu von Vorteil Hohe Eigenverantwortung und Selbstorganisation Hands-on-Mentalität Ausgeprägte Teamfähigkeit in kleinen Teams Belastbarkeit und Effizienz in hektischen Servicezeiten Flexibilität (Einsatz in verschiedenen Bereichen) Qualitätsbewusstsein und saubere Arbeitsweise Gästeorientiertes Denken und Auftreten Lernbereitschaft und Offenheit für neue Konzepte Verlässlichkeit
",
"offer": "Deine Vorteile bei uns",
"contact": "Genossenschaft ZFV-Unternehmungen
Wenzel Domenica
Flüelastrasse 51
8047 Zürich
dwenzel@zfv.ch
+41 44 388 35 35",
"url_application": "https://jobs.zfv.ch/koechin-koch-70-80-de-f4450.html?jobPipeline=jobbasel.ch",
"url_description": "https://www2.solique.ch/cgi-bin/WebObjects/UNUserInterface.woa/wa/getSinglePublicationData?publicationId=4039111",
"is_shown_on_company_minisite": false,
"company_description": "Am neuen Standort der ETH Gastronomie in Basel stehen erlebbare Frische, saisonale Highlights und umweltfreundliche und ausgewogene Ernährung im Zentrum für unsere Gäste. Mit dem Bistro Flavour Kitchen und der Science Lounge im 5.OG bereichern wir das architektonisch spannende Gebäude BSS mit unserer Gastronomie und Gastfreundschaft.|ETH Gastronomie Basel
",
"type_key": 5,
"type_value_min": 70,
"type_value_max": 80,
"date_actualization": "2026-07-16",
"date_start": "2026-07-16",
"date_first_published": "2026-07-16 10:10:35.705928+0200",
"is_special_offer": false,
"is_promoted": false,
"home_office": false,
"position": [],
"external_id": "3122849.4039111",
"country_code": [
"ch"
],
"company": {
"id": 26824,
"name": "Genossenschaft ZFV-Unternehmungen",
"description": "«Gastfreundschaft für eine Gesellschaft, in der wir alle leben wollen». Dafür setzen wir uns als Genossenschaft ein. In schweizweit über 200 Begegnungsorten streben wir danach, unsere Vision erlebbar zu machen. Dabei lassen wir uns von unseren Gründerinnen inspirieren, die sich bereits 1894 mutig für gesellschaftliche Themen engagierten: Wir fördern auch heute gesunde und nachhaltige Verpflegung sowie Lebens- und Arbeitsweisen. Und wir setzen auf Chancengerechtigkeit und Inklusion.",
"homepage": "https://www.zfv.ch/de",
"additional_address": "",
"vacancy_list_style_class": "Ostjob_Vacancy_ListStyle_Default",
"zip": "8047",
"city": "Zürich (Albisrieden)",
"hide_first_publication_date": false,
"street": "Flüelastrasse",
"house_number": "51",
"po_box": "Postfach",
"country": "Schweiz",
"additional_name": "",
"main_phone_number": "+41 44 388 35 35",
"pdf_preview_enable": true,
"contact_and_application_url_enable": true,
"vacancies_in_popup": false,
"is_shown_iframe_on_mobile_pages": true,
"show_template_on_mobile": false,
"logo_id": "53d1744f6b66f1d58e81",
"country_of_origin_code": "ch",
"is_free_company": false
},
"categories": [
{
"id": 56,
"title": "Gastronomie, Hotellerie, Tourismus, Lebensmittel",
"description": "",
"order_position": 9,
"is_active": true,
"platform_id": [
8
]
}
],
"address_country": "ch"
}
```
Each scraped job returns a comprehensive record with 28+ structured fields:
#### Core Identification
| Field | Meaning | Example |
|---|---|---|
| `ID` | Unique JobBasel internal identifier for the job posting | `12345678` |
| `Title` | Official job title as displayed | `Business Development Executive` |
| `External ID` | Third-party or partner-provided job ID | `EXT-9876` |
| `Position` | Number of open positions or role priority ranking | `3` |
#### Company & Organization Information
| Field | Meaning | Example |
|---|---|---|
| `Company` | Employer name and organization | `TechCorp AG` |
| `Company ID` | Unique company identifier in JobBasel's database | `5432` |
| `Company Description` | Summary of the company's business and mission | `Leading software development firm...` |
| `Shown On Company Minisite` | Whether the job appears on employer's JobBasel profile | `true/false` |
#### Location Details
| Field | Meaning | Example |
|---|---|---|
| `Workplace City` | Job location city | `Basel` |
| `Workplace ZIP` | Postal code of workplace | `4051` |
| `Address Country` | Country code or name | `CH` or `Switzerland` |
| `Country Code` | ISO country code for the job location | `CH` |
#### Job Specifics & Classification
| Field | Meaning | Example |
|---|---|---|
| `Type Key` | Employment type identifier (used with Type Value) | `employment_type` |
| `Type Value Min` | Minimum contract value or entry level | `100` (%) or hours/week |
| `Type Value Max` | Maximum contract value or range | `100` (%) or hours/week |
| `Categories` | Industry sectors or job categories | `['IT', 'Software Development']` |
| `Activity` | Industry activity or business sector | `Software & IT Services` |
| `Home Office` | Remote/home office eligibility flag | `true/false` |
#### Content & Requirements
| Field | Meaning | Example |
|---|---|---|
| `Requirements` | Candidate qualifications and experience needed | `5+ years experience, Swiss residency preferred` |
| `Offer` | Key benefits and compensation summary | `CHF 120K-150K, 25 days vacation` |
| `Contact` | HR contact person or department information | `hr@techcorp.ch` |
| `Description URL` | URL linking to full job description (on external site if applicable) | `https://www.jobbasel.com/job/...` |
| `Application URL` | Direct link to submit application or external career page | `https://apply.techcorp.ch/job/123` |
#### Dates & Timeline
| Field | Meaning | Example |
|---|---|---|
| `Date First Published` | Initial posting date | `2024-01-15` |
| `Date Start` | Desired job start date or earliest start | `2024-03-01` |
| `Date Actualization` | Last update/refresh timestamp | `2024-02-20` |
#### Listing Flags & Visibility
| Field | Meaning | Example |
|---|---|---|
| `Promoted` | Whether the listing has paid promotion/boost | `true/false` |
| `Special Offer` | Special recruitment initiative or incentive flag | `true/false` |
***
### How to Use
1. **Identify job URLs** — Navigate to JobBasel.ch, find specific job detail pages, and copy their URLs. Ensure you copy the full job detail page URL, not search results pages.
2. **Prepare input** — Paste one or multiple job URLs into the `urls` array. You can add URLs one at a time or use bulk edit to paste a prepared list.
3. **Configure failure handling** — Set `ignore_url_failures: true` (recommended) to allow the scraper to continue if some URLs fail, or `false` to stop on the first error.
4. **Run the scraper** — Execute the actor and monitor progress in the run log.
5. **Download results** — Export output in JSON, CSV, or Excel format for analysis, integration, or storage.
**Common scenarios:**
- Single job extraction: Use one URL for detailed review or data verification.
- Batch collection: Paste 10-100+ URLs to build a competitive job database.
- Ongoing monitoring: Schedule recurring runs on the same URLs to track updates and changes.
***
### Use Cases & Business Value
- **Talent acquisition:** Build a searchable Swiss job database for candidate matching and market gap identification
- **Competitive intelligence:** Monitor competitor job postings, team expansion, and hiring patterns
- **Salary benchmarking:** Collect compensation data across Swiss companies and industries for HR strategy
- **Academic research:** Analyze Swiss labor market trends, skill demands, and regional employment distribution
- **Career platform integration:** Feed JobBasel listings into custom job aggregators or internal talent marketplaces
The **JobBasel Jobs Scraper** transforms hours of manual data collection into minutes of automated extraction, enabling data-driven recruitment and market analysis.
***
### Conclusion
The **JobBasel Jobs Details Scraper** is an efficient, reliable tool for anyone needing structured Swiss employment data. Whether you're a recruiter, HR analyst, researcher, or platform developer, this scraper delivers the comprehensive job records needed to unlock actionable insights from JobBasel.ch. Start scraping today and gain a competitive edge in the Swiss job market.
# 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.jobbasel.com/job/business-development-executive-127109153"
],
"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 '' with your token
const client = new ApifyClient({
token: '',
});
// Prepare Actor input
const input = {
"urls": [
"https://www.jobbasel.com/job/business-development-executive-127109153"
],
"ignore_url_failures": true
};
// Run the Actor and wait for it to finish
const run = await client.actor("alexist/jobbasel-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 '' with your token.
client = ApifyClient("")
# Prepare the Actor input
run_input = {
"urls": ["https://www.jobbasel.com/job/business-development-executive-127109153"],
"ignore_url_failures": True,
}
# Run the Actor and wait for it to finish
run = client.actor("alexist/jobbasel-jobs-details-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 '{
"urls": [
"https://www.jobbasel.com/job/business-development-executive-127109153"
],
"ignore_url_failures": true
}' |
apify call alexist/jobbasel-jobs-details-scraper --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=alexist/jobbasel-jobs-details-scraper",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Jobbasel Jobs Details Scraper",
"description": "Scrape detailed job postings from JobBasel.ch with precision. This scraper extracts 28+ fields including titles, company details, location data, dates, application URLs, and employment types — essential for recruiters, HR professionals, and Swiss labor market researchers.",
"version": "0.0",
"x-build-id": "9GTnPmolY1LVw4EhG"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/alexist~jobbasel-jobs-details-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-alexist-jobbasel-jobs-details-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/alexist~jobbasel-jobs-details-scraper/runs": {
"post": {
"operationId": "runs-sync-alexist-jobbasel-jobs-details-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/alexist~jobbasel-jobs-details-scraper/run-sync": {
"post": {
"operationId": "run-sync-alexist-jobbasel-jobs-details-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",
"properties": {
"urls": {
"title": "URLs of the Specific jobs urls to scrape",
"type": "array",
"description": "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.",
"items": {
"type": "string"
}
},
"ignore_url_failures": {
"title": "Continue running even if some URLs fail to be scraped",
"type": "boolean",
"description": "If true, the scraper will continue running even if some URLs fail to be scraped."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```