Bundesagentur für Arbeit (Arbeitsagentur) Scraper

Search and export public German job listings from the Bundesagentur für Arbeit Jobsuche.

Data fields

FieldTypeDescription
referenceIdstringValue exported as referenceId.
titlestringValue exported as title.
employerstringValue exported as employer.
locationstringValue exported as location.
employmentTypesarrayValue exported as employmentTypes.
salaryTextstringValue exported as salaryText.
startDateTextstringValue exported as startDateText.
contractDurationstringValue exported as contractDuration.

Input preview

queryPosition or keyword
locationLocation
startUrlsOfficial Jobsuche URLs
maxItemsMaximum job listings
pageStartStarting page

API and agents

This actor can be run through Apify API, datasets, webhooks, schedules, and the official Apify MCP server.

Ready-to-run examples

Open a saved Apify example, adjust the input, and run the actor in your own Apify account.

View all examples

How this actor works

See example inputs, outputs, API usage, and practical limits before running this actor on Apify.

Open Apify page

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 maxItems after 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.

Common questions

Questions and answers reused from the canonical actor README.

Does it require a login?

No. It reads public job-search pages.

Can I search by location?

Yes, use location with a German city or region.

Why are some salary fields empty?

Many employers do not show salary on the search card; the Actor does not invent missing values.