Search the official Bundesagentur für Arbeit Jobsuche and export structured German job listings. Use the dataset for recruiting research, job-market analysis, lead lists, and recurring vacancy monitoring.
What you can export
Each result includes the job title, employer, work location, employment types, salary/start/contract text when shown, canonical job URL, employer logo, stable reference ID, and search provenance.
Example input
{
"query": "Softwareentwickler",
"location": "Berlin",
"maxItems": 20
}
Example output
{
"referenceId": "20931-g0q5q54ys5-S",
"title": "Pflegefachkraft (m/w/d)",
"employer": "Bayerisches Rotes Kreuz Kreisverband Straubing-Bogen",
"location": "Mallersdorf-Pfaffenberg",
"employmentTypes": ["Vollzeit", "Teilzeit"],
"salaryText": "",
"startDateText": "",
"contractDuration": "",
"portalUrl": "https://www.arbeitsagentur.de/jobsuche/jobdetail/20931-g0q5q54ys5-S",
"employerLogoUrl": "https://rest.arbeitsagentur.de/vermittlung/ag-darstellung-service/ct/v1/arbeitgeberlogo/example",
"sourceQuery": "Pflegefachkraft",
"sourceLocation": "",
"sourcePage": 1,
"scrapedAt": "2026-09-07T14:24:29.607Z"
}
Input settings
| Field | Type | Description |
|---|---|---|
query |
string | Position, occupation, skill, or keyword |
location |
string | Optional German city or region |
startUrls |
array | Optional official Jobsuche search URLs; overrides query/location |
maxItems |
integer | Maximum unique job listings (1–1,000) |
pageStart |
integer | Search page to begin at |
Who is it for?
- Recruiters and staffing teams tracking fresh vacancies by occupation and location.
- Job boards and career products collecting structured public listings for analysis or discovery.
- Labor-market analysts comparing demand across German cities, employers, and employment types.
- Automation teams feeding recurring searches into spreadsheets, databases, alerts, or AI agents.
Tips and limits
- Start with 20 results, then raise
maxItemsafter checking relevance. - Public listings can change or expire between runs.
- Optional card fields are empty strings when the employer does not publish them.
- Source availability and page changes can affect result volume.
API usage
cURL
curl -X POST "https://api.apify.com/v2/acts/fetch_cat~bundesagentur-fur-arbeit-arbeitsagentur-scraper/runs?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"query":"Data Engineer","location":"Hamburg","maxItems":20}'
JavaScript
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('fetch_cat/bundesagentur-fur-arbeit-arbeitsagentur-scraper').call({
query: 'Data Engineer',
location: 'Hamburg',
maxItems: 20,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);
Python
import os
from apify_client import ApifyClient
client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('fetch_cat/bundesagentur-fur-arbeit-arbeitsagentur-scraper').call(
run_input={'query': 'Data Engineer', 'location': 'Hamburg', 'maxItems': 20}
)
items = client.dataset(run['defaultDatasetId']).list_items().items
print(items)
MCP and agents
Connect the Actor to Claude Code:
claude mcp add apify --transport http \
"https://mcp.apify.com/?tools=fetch_cat/bundesagentur-fur-arbeit-arbeitsagentur-scraper"
Or add this server to an MCP client configuration:
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com/?tools=fetch_cat/bundesagentur-fur-arbeit-arbeitsagentur-scraper"
}
}
}
Example prompts:
- “Find 20 Pflegefachkraft vacancies near München and summarize the hiring employers.”
- “Export Data Engineer jobs in Hamburg and group them by employment type.”
- “Monitor Softwareentwickler listings in Berlin and highlight new reference IDs.”
Support
Open an issue on this Actor's Apify Store page with the input and affected URL. Do not include passwords, cookies, or private data.