Arbeitsagentur.de Scraper - German Federal Job Board
Pricing
from $3.00 / 1,000 job serp results
Arbeitsagentur.de Scraper - German Federal Job Board
Extract jobs from Germany's official employment agency (Bundesagentur für Arbeit): titles, companies, locations, salaries, descriptions and contact details where available. Supports search filters, direct search URLs and job status checks.
Pricing
from $3.00 / 1,000 job serp results
Rating
5.0
(1)
Developer
NanoScrape
Maintained by CommunityActor stats
3
Bookmarked
79
Total users
8
Monthly active users
a day ago
Last modified
Categories
Features
Share
Arbeitsagentur.de Job Scraper
Scraper for job listings from Arbeitsagentur.de (Bundesagentur fur Arbeit), the German Federal Employment Agency's official job portal.
The actor now honors the platform's SERP filter and sort params 1:1: sort order, publication date window, employment type, and homeoffice percentage are all applied server-side before results are returned.
Features
- Pure HTTP Architecture: No browser needed -- fast API-based search (~80MB memory)
- Multi-Query Support: Run multiple search keywords in a single run with automatic deduplication
- Application Contacts: With job details on, adds the contact person, email and phone from the listing's application section
- Rich Company Data: Company logo, website (Homepage), description, and "Alle Stellen" link via employer profile API
- Full Job Descriptions: Complete text with structured salary, dates, and remote work flags
- Sort + Filter Options: Sort by newest or relevance, filter by publication date, employment type, and homeoffice percentage
- Direct URL Mode: Check status of specific job listings
- Standardized Output: Compatible with the Santamaria ecosystem
JobListingschema
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/arbeitsagentur-de-scraper
Example prompt once connected:
"Use
arbeitsagentur-de-scraperto scrape job listings from arbeitsagentur de. 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.
How It Works
- Search Phase: Uses the public REST API (
v6/jobs) withX-API-Keyauthentication. Sort, age filter, employment type, and homeoffice params are forwarded directly to the API. - Job Details API (optional): Fetches rich structured data from
v4/jobdetails-- full description, salary range, dates, employment flags - Employer Profile API: Fetches company description, Homepage link, and logo URL from
ag-darstellung-service - Application Contact (with job details): Reads the application contact published for the listing (name, email, phone)
All steps use pure HTTP -- no browser or Playwright required.
Search, job details and the employer profile are fetched through a proxy fallback chain (datacenter, then residential in Germany, then an unblocker as the last step), never from a direct connection. The contact step keeps its own connection handling.
Apply links (apply_url, external_apply_url) are returned without utm_* tracking parameters; all other parameters stay. description_full is trimmed, and when it is plain text its HTML entities are decoded (HTML descriptions are only trimmed).
Input
| Field | Type | Default | Description |
|---|---|---|---|
searchQueries | string[] | - | Multiple search keywords (each runs as separate search, deduplicated) |
searchQuery | string | - | Single search keyword (legacy, backward compatible) |
titleFilter | string | - | Comma-separated terms for title filtering (case-insensitive OR-match, applied post-SERP before detail fetch). Empty disables the filter. Reduces costs by skipping non-matching jobs entirely. |
location | string | - | City or region (Wo) |
radius | integer | not set | Optional search radius in km around location (0 to 200, sent as umkreis). 0 means the exact place. Needs a location: without one it is ignored with a warning. |
bundesland | string | All states | Federal state code (see table below) |
sortBy | string | newest | newest (sort=veroeffdatum) or relevance (sort=relevanz) |
employmentType | string | All types | FULL_TIME, PART_TIME, INTERNSHIP, APPRENTICESHIP, CONTRACT |
workingTime | string[] | not set | Optional working time models, sent as arbeitszeit: full_time (vz), part_time (tz), shift_night_weekend (snw), mini_job (mj). Combined with an employmentType of FULL_TIME or PART_TIME the codes are merged without duplicates (for example FULL_TIME plus part_time gives vz;tz). There is no home office value: the site treats home office as its own filter, use remotePercentageMin for it. |
offerType | string | All offer types | work, self_employed, training, internship_trainee (see Offer Types below). Replaces the offer type an employmentType of INTERNSHIP, APPRENTICESHIP or CONTRACT would set. |
postedWithinDays | integer | 0 (no filter) | Only return jobs posted within last N days. Passed as veroeffentlichtseit (any integer). |
remotePercentageMin | integer | 0 (no filter) | Minimum homeoffice percentage. Set to 100 for fully remote only. |
maxResultsPerQuery | integer | 100 | Maximum results per search keyword |
maxResults | integer | 0 (unlimited) | Total cap across all queries |
includeJobDetails | boolean | false | Extract contact details and full job details: contact person, email and phone where shown, full description, company website, logo (~3-5s/job) |
onlyNewSinceLastRun | boolean | false | For daily monitoring: skip jobs delivered in earlier runs with the same search settings. See Only New Jobs below. |
directUrls | array | - | Specific job URLs to scrape |
Bundesland Codes
| Code | State |
|---|---|
BW | Baden-Wurttemberg |
BY | Bayern (Bavaria) |
BE | Berlin |
BB | Brandenburg |
HB | Bremen |
HH | Hamburg |
HE | Hessen |
MV | Mecklenburg-Vorpommern |
NI | Niedersachsen |
NW | Nordrhein-Westfalen |
RP | Rheinland-Pfalz |
SL | Saarland |
SN | Sachsen |
ST | Sachsen-Anhalt |
SH | Schleswig-Holstein |
TH | Thuringen |
Employment Types
| Value | API Param | Platform label |
|---|---|---|
FULL_TIME | arbeitszeit=vz | Vollzeit |
PART_TIME | arbeitszeit=tz | Teilzeit |
INTERNSHIP | angebotsart=34 | Praktikum / Trainee |
APPRENTICESHIP | angebotsart=4 | Ausbildung |
CONTRACT | angebotsart=2 | Freiberuflich / Selbststaendig |
Offer Types
| Value | API Param | Platform label |
|---|---|---|
work | angebotsart=1 | Arbeit (employment) |
self_employed | angebotsart=2 | Selbststaendigkeit |
training | angebotsart=4 | Ausbildung / duales Studium |
internship_trainee | angebotsart=34 | Praktikum / Trainee |
Only New Jobs
With onlyNewSinceLastRun on, the actor keeps the IDs of the jobs it delivered in a named key-value store in your account (arbeitsagentur-seen-<hash>, one per distinct search: keywords, location, state, employment type, offer type, age filter, title filter). Jobs seen in an earlier run are skipped before details are fetched and before you are charged. The list holds the last 50,000 IDs. The run status reads "N new jobs since the last run." (or "No new jobs since the last run."). Caps, sort order and includeJobDetails do not change which list is used. Not used with directUrls.
Sort Options
| Value | API Param | Behavior |
|---|---|---|
newest | sort=veroeffdatum | Publication date descending (freshest jobs first) |
relevance | sort=relevanz | Platform relevance ranking (API default) |
Output
Each job listing includes:
{"id": "12345-10000000000-S","title": "Pflegeassistent /in","company": "Beispiel Pflege GmbH","location": "10179, Berlin","country": "DE","canton": null,"salary_min": 12.82,"salary_max": 12.82,"salary_currency": "EUR","salary_period": "hourly","salary_text": "12,82 EUR/Std.","employment_type": "full-time","workload_min": null,"workload_max": null,"remote_option": null,"description_snippet": "Fur [mehrere] Standorte des Grossraums Berlin...","description_full": "Full job description with markdown formatting...","requirements": ["Abgeschlossene Ausbildung als Pflegefachkraft", "Bereitschaft zur Schichtarbeit"],"company_benefits": ["Betriebliche Altersvorsorge", "30 Tage Urlaub"],"posted_at": "2026-02-26T00:00:00.000Z","modified_at": "2026-02-26T14:51:45.062Z","expires_at": null,"source_url": "https://www.arbeitsagentur.de/jobsuche/jobdetail/12345-10000000000-S","source_platform": "arbeitsagentur.de","contact_salutation": "Frau","contact_firstname": "Anna","contact_lastname": "Muster","contact_email": "jobs@example-pflege.de","contact_phone": "+49301234567","contact_emails": ["jobs@example-pflege.de"],"contact_phones": ["+49301234567"],"apply_url": "https://www.example-pflege.de/jobs/pflegeassistent","apply_email": "jobs@example-pflege.de","company_url": null,"company_website": "https://www.example-pflege.de/","latitude": 52.5463,"longitude": 13.3615,"external_apply_url": "https://www.example-pflege.de/jobs/pflegeassistent","company_logo_url": "https://rest.arbeitsagentur.de/.../arbeitgeberlogo/QCGq...","company_description": "Beispiel Pflege - Unternehmensprofil...","company_jobs_url": "https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&arbeitgeberKundennummerHash=...","search_query": "Pflege","scraped_at": "2026-03-04T15:36:48.707Z","detail_status": "ok"}
Field Reference
| Field | Source | Requires includeJobDetails |
|---|---|---|
company_website | Employer profile API (Homepage link) | Yes |
latitude, longitude | Work location coordinates of the listing (first location); null when absent | No |
external_apply_url | The employer's own application URL when the listing links out; null otherwise. apply_url is unchanged | No |
company_logo_url | Constructed from arbeitgeberKundennummerHash | Yes |
company_description | Employer profile API | Yes |
company_jobs_url | Constructed from employer hash | Yes |
description_full | v4 jobdetails API | Yes |
modified_at | v4 jobdetails API (aenderungsdatum) | Yes |
salary_min/max/period | v4 jobdetails API | Yes |
contact_* | Application contact (bewerbung), otherwise the person, phone numbers and email addresses written in the job description | Yes |
contact_emails, contact_phones | Every address and number found: application contact first, then the description text. Numbers are kept as written, including extensions | Yes |
requirements | Bullet items under the profile heading of the job description ("Ihr Profil", "Das bringen Sie mit") | Yes |
company_benefits | Bullet items under the offer heading of the job description ("Wir bieten", "Das bieten wir dir") | Yes |
remote_option | v4 jobdetails API | Yes |
search_query | Input search keyword that found this job | No |
detail_status | "ok" when the detail page was read, "failed" when details were requested but the page failed or was empty, "summary" when details were not requested (description_full is then only the search summary) | No |
Usage
Scheduled Daily Scrape (recommended)
Best practice for pipelines: newest jobs only, full-time, posted today.
{"searchQueries": ["Softwareentwickler"],"sortBy": "newest","postedWithinDays": 1,"employmentType": "FULL_TIME","maxResultsPerQuery": 200}
Precision Daily Scrape (title filter)
Combine newest-first with a title filter to receive only the specific role categories you care about. Jobs that do not match any term are dropped before detail fetch, so you pay only for relevant results.
{"searchQueries": ["Software", "IT", "Entwickler"],"sortBy": "newest","postedWithinDays": 1,"titleFilter": "Engineer, Entwickler, Developer, Architect","employmentType": "FULL_TIME","maxResultsPerQuery": 200}
Multi-Query Search
{"searchQueries": ["Pflege", "Krankenschwester", "Altenpfleger"],"location": "Berlin","maxResultsPerQuery": 50,"maxResults": 0,"includeJobDetails": false}
Remote Jobs Only
{"searchQueries": ["Softwareentwickler"],"sortBy": "newest","remotePercentageMin": 100,"maxResultsPerQuery": 100}
Quick Search (without contact details)
{"searchQueries": ["Elektriker"],"location": "Munchen","maxResultsPerQuery": 50,"includeJobDetails": false}
Full Extraction (with contact details)
{"searchQueries": ["Pflege"],"bundesland": "BY","maxResultsPerQuery": 20,"includeJobDetails": true}
Legacy Single Query (backward compatible)
{"searchQuery": "Softwareentwickler","location": "Berlin","maxResults": 100,"includeJobDetails": true}
Precision title filter
Returns only German engineering jobs whose title contains "ingenieur" or "entwickler" (case-insensitive substring match). Non-matching SERP rows are dropped before the detail-fetch step, so you don't pay for job-detail events on jobs you don't want. Jobs whose detail page could not be loaded are billed as search results.
{"searchQueries": ["software"],"titleFilter": "ingenieur, entwickler","sortBy": "newest","maxResults": 50}
Example matched titles: "Softwareentwickler (m/w/d) Java Backend", "Ingenieur fur Automatisierungstechnik".
Via API
curl -X POST "https://api.apify.com/v2/acts/santamaria~arbeitsagentur-de-scraper/runs" \-H "Authorization: Bearer YOUR_API_TOKEN" \-H "Content-Type: application/json" \-d '{"searchQueries": ["Softwareentwickler", "Programmierer"],"location": "Berlin","sortBy": "newest","employmentType": "FULL_TIME","postedWithinDays": 7,"maxResultsPerQuery": 100,"includeJobDetails": true}'
Performance and Cost
| Mode | Memory | Speed | CU (50 jobs) |
|---|---|---|---|
Search only (includeJobDetails: false) | ~40 MB | ~25 jobs/sec | ~0.005 |
With details (includeJobDetails: true) | ~120 MB | ~1 job/3-5 sec | ~0.05 |
Tip: Use includeJobDetails: false (default) for high-volume scraping, enable only when you need contact details and company data.
Limitations
- Rate Limiting: 2s delay between requests to avoid blocks
- Salary Data: German job listings rarely include salary information
- Job Expiration: API doesn't provide expiration dates
- Contact Availability: Not all listings publish application contact details
- Company Website: Only available when the employer has configured a Homepage link in their profile
Related Actors
Working across the German job market? These complement Arbeitsagentur.de:
Germany
- StepStone.de Scraper -- a German private job board (market-side peer to this federal government portal).
- Stellenmarkt.de Scraper -- a German national job board (generalist).
- Stellenanzeigen.de Scraper -- German national job board (generalist).
- Jobware.de Scraper -- German IT/engineering specialist board.
- Meine Stadt Scraper -- German local/regional jobs by city.
- Nicejob.de Scraper -- German job board with company-culture focus.
- E-Fellows Scraper -- German student/graduate jobs and internships.
Switzerland
Austria
Global
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 and Phone Scraper -- Fast email and phone extraction (no AI needed)
Changelog
- 4.5.2: radius and working time filters, shared proxy fallback chain, cleaner apply links.
- 4.5.0: offer type filter, coordinates, external apply URL, only-new mode for daily monitoring, status message fixed.
Support
For issues or feature requests: Actor Issues | API Reference
Part of the Santamaria Job Scrapers Suite - Professional-grade job data for the DACH region.
Built with Apify | Arbeitsagentur.de
You are responsible for using the data lawfully, including the GDPR/DSGVO, national data-protection laws and unfair-competition rules (e.g. UWG) for marketing and outreach.