Jobbasel.ch Job Scraper

Scrapes job listings from jobbasel.ch, the leading job portal for Basel.

Features

• Multi-query support - Run multiple search keywords in a single actor run, deduplicated across queries
• Per-query limits - Control how many results each keyword returns
• API-based scraping - Uses the official 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)
• HR company filtering - Filter out recruitment agencies to get direct employer postings
• Still alive checks - Verify if specific job URLs are still active via Direct URL mode
• Company details - Returns company website, about text, address, logo, and social URLs from the CH-Media API at no extra HTTP cost
• Standardized output - Returns data in the JobListing schema format with search_query tracking

Use with AI Agents (MCP)

Connect this actor to any MCP-compatible AI client — Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or custom agents.

Apify MCP server URL:

https://mcp.apify.com?tools=santamaria-automations/jobbasel-ch-scraper

Example prompt once connected:

"Use jobbasel-ch-scraper to scrape job listings from jobbasel ch. Return results as a table."

Clients that support dynamic tool discovery (Claude.ai, VS Code) will receive the full input schema automatically via add-actor.

Input

Field	Type	Description	Default
searchQueries	string[]	One or more search keywords (multi-query). Each runs as a separate search, deduplicated.	["Informatiker"]
searchQuery	string	Legacy single search query. Use searchQueries instead.	""
directUrls	string[]	Job URLs to scrape directly (for still alive checks)	[]
location	string	Canton, district, or city name. Auto-resolves via API.	"" (all Basel)
maxResultsPerQuery	integer	Max results per search keyword	100
maxResults	integer	Total cap across all queries. 0 = unlimited.	0
sortOrder	string	by_relevance or by_date (newest first)	by_relevance
workloadMin	integer	Minimum workload/Pensum percentage (0-100)	-
workloadMax	integer	Maximum workload/Pensum percentage (0-100)	-
includeJobDetails	boolean	Fetch full job descriptions	true
companyFilter	string	all, exclude-hr, only-hr	all
proxyConfiguration	object	Apify proxy settings	Residential

Multi-Query Example

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

This runs 3 searches, each returning up to 50 results. Jobs appearing in multiple searches are deduplicated. Each result includes a search_query field showing which keyword found it.

Output

{
  "id": "12345",
  "title": "Software Entwickler (m/w/d)",
  "company_name": "Tech Solutions AG",
  "location": "Basel, 4001, BS",
  "canton": "BS",
  "employment_type": "full-time",
  "workload_min": 80,
  "workload_max": 100,
  "job_url": "https://www.jobbasel.ch/job/software-entwickler/12345",
  "source_platform": "jobbasel.ch",
  "search_query": "Informatiker",
  "posted_at": "2026-01-15T00:00:00.000Z",
  "company_website": "https://www.techsolutions.ch",
  "company_about": "Tech Solutions AG ist ein innovatives Schweizer IT-Unternehmen...",
  "company_address": "Musterstrasse 1, 4001, Basel, CH",
  "company_logo_url": "https://api.jobbasel.ch/public/image/logo456",
  "company_social_urls": ["https://www.linkedin.com/company/tech-solutions-ag"],
  "scraped_at": "2026-03-17T12:00:00.000Z"
}

Output fields

Field	Type	Description
id	string	Job ID on jobbasel.ch
title	string	Job title
company_name	string	Employer name
location	string	City, ZIP, canton
canton	string	Swiss canton code (BS, BL, etc.)
job_url	string	Direct URL to job listing
apply_url	string	Application URL
posted_at	string	ISO 8601 post date
expires_at	string	ISO 8601 expiry date
description_snippet	string	Short job description excerpt
description_full	string	Full job description
employment_type	string	full-time / part-time
workload_min / workload_max	number	Pensum % range
remote_option	string	hybrid / onsite
contact_email / contact_phone	string	Contact details
company_website	string	Employer own website
company_about	string	Company description from API
company_address	string	Company address (street, zip, city, country)
company_logo_url	string	Company logo URL
company_social_urls	string[]	Social media profile URLs
company_benefits	string[]	Company benefits from API
search_query	string	Search keyword that found this job

Deprecation notes

The following field names are deprecated and will be removed after 2027-09-16 (one-year backward-compatibility window):

• company - use company_name (canonical since 2026-09-16)
• source_url - use job_url (canonical since 2026-09-16)
• company_url - use company_website (canonical since 2026-09-16)
• company_description - use company_about (canonical since 2026-09-16)

Both the deprecated and canonical fields are emitted in every dataset row during the transition window. Please migrate downstream consumers to the canonical names before the removal date.

Direct URL Mode (Still Alive Checks)

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

Each job will have job_status: "online" or "offline".

Performance

• Speed: ~100-200 jobs/minute (4-second rate limit between requests)
• Cost: ~0.01-0.03 CU per 500 jobs
• Memory: 256-512 MB

Data Source

• Website: jobbasel.ch
• API: Public vacancy search API (CH-Media Group)
• Coverage: Basel region (BS, BL)

Related Actors

Looking for more job data? Check out our other scrapers:

Switzerland

• Jobs.ch Scraper
• JobScout24 Scraper
• ICTjobs.ch Scraper
• SwissDevJobs Scraper

Germany

• StepStone.de Scraper
• Stellenanzeigen.de Scraper

Global

• LinkedIn Jobs Scraper
• Indeed Scraper

Enrich your job data

• Website Job Extractor -- Extract jobs directly from company career pages
• Website Contact Extractor -- Get emails and phone numbers from company websites
• Website Email & Phone Scraper -- Fast email and phone extraction (no AI needed)

---

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