Zentraljob.ch Job Scraper

Scrapes job listings from zentraljob.ch, the leading job portal for Central Switzerland.

Three Scraping Modes

1. SEARCH MODE (Default)

Search for jobs using query/location filters. Supports multiple search queries in a single run.

2. MULTI-QUERY MODE

Run multiple search queries in a single actor run with per-query limits and deduplication.

{
  "searchQueries": ["Informatiker", "Pflege", "Buchhaltung"],
  "location": "Luzern",
  "maxResultsPerQuery": 50,
  "maxResults": 0
}

3. DIRECT URL MODE

Check if specific job URLs are still online (still alive checks).

{
  "directUrls": [
    "https://www.zentraljob.ch/job/software-entwickler/12345",
    "https://www.zentraljob.ch/job/projekt-manager/67890"
  ]
}

Features

• Multi-query support - Run multiple search queries in a single actor run with per-query limits
• API-based scraping - Uses the official Zentraljob API for fast, reliable data extraction
• Smart location filtering - Enter any canton, district, or city name - auto-resolves via API
• Sort by date - Get newest jobs first for job monitoring use cases
• Workload filter - Filter by Pensum percentage (e.g., 40-60% for part-time)
• Regional focus - Specializes in jobs from Central Switzerland (Luzern, Zug, Schwyz, etc.)
• HR company filtering - Filter out recruitment agencies to get direct employer postings
• LLM-powered contact extraction - Optional AI-powered extraction of contact person details
• Still alive checks - Verify if specific job URLs are still active
• Standardized output - Returns data in the JobListing schema format with search_query tracking

Input

Field	Type	Description	Default
directUrls	array	List of job URLs to scrape directly	[]
searchQueries	string[]	List of search queries to run (multi-query mode)	[]
searchQuery	string	Single search query (backward compatible)	""
location	string	Canton, district, or city name	"" (all Central Switzerland)
maxResults	integer	Maximum total results. 0 = unlimited.	0
maxResultsPerQuery	integer	Maximum results per individual query	100
sortOrder	string	by_relevance or by_date	by_relevance
workloadMin	integer	Minimum workload percentage (0-100)	-
workloadMax	integer	Maximum workload percentage (0-100)	-
includeJobDetails	boolean	Fetch full job descriptions	true
companyFilter	string	all, exclude-hr, only-hr	all
llmApiKey	string	API key for LLM contact extraction	-
llmModel	string	LLM model for contact extraction	none
proxyConfiguration	object	Apify proxy settings	Residential

Output

Each job listing follows the standardized JobListing schema:

{
  "id": "12345",
  "title": "Software Entwickler (m/w/d)",
  "company": "Tech Solutions AG",
  "location": "Luzern, 6000, LU",
  "canton": "LU",
  "search_query": "Informatiker",
  "employment_type": "full-time",
  "workload_min": 80,
  "workload_max": 100,
  "source_url": "https://www.zentraljob.ch/job/software-entwickler/12345",
  "source_platform": "zentraljob.ch",
  "scraped_at": "2024-01-16T12:00:00.000Z"
}

Covered Regions

Zentraljob.ch specializes in jobs from Central Switzerland:

Canton	Major Cities
LU	Luzern, Emmen, Kriens
ZG	Zug, Baar, Cham
SZ	Schwyz, Einsiedeln
NW	Stans
OW	Sarnen
UR	Altdorf

Performance

• Speed: ~100-200 jobs/minute (limited by respectful rate limiting)
• Cost: ~0.01-0.03 CU per 500 jobs
• Reliability: Built-in retry logic and error handling

Data Source

• Website: zentraljob.ch
• API: Public vacancy search API (https://api.zentraljob.ch/public/vacancy/)
• Coverage: Central Switzerland

Legal Notice

This actor accesses publicly available job listings through the API. Please ensure your use case complies with the zentraljob.ch terms of service.

---

Part of the Santamaria Job Scrapers Suite - Professional-grade job data for the DACH region and beyond.

Need help with integration, aggregation, or custom scraping solutions? Contact us at contact@alessandrosantamaria.com