Bundesagentur für Arbeit (Arbeitsagentur) Scraper

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

Output fields

Field	Description
referenceId	Stable job reference parsed from the official URL
title	Job title
employer	Hiring organization
location	Work location
employmentTypes	Full-time, part-time, or other displayed arrangements
salaryText	Salary text when displayed
startDateText	Start date text when displayed
contractDuration	Displayed fixed/permanent contract status
portalUrl	Canonical official job-detail URL
employerLogoUrl	Public employer logo URL when displayed
sourceQuery	Query used for the search
sourceLocation	Location used for the search
sourcePage	Results page where the listing appeared
scrapedAt	UTC extraction timestamp

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.

Input recipes

Monitor nursing jobs: {"query":"Pflegefachkraft","location":"München","maxItems":50}

Research software vacancies: {"query":"Softwareentwickler","location":"Berlin","maxItems":100}

Start from page 2 (skip earlier result cards): {"query":"Elektriker","location":"Köln","pageStart":2,"maxItems":40}

Use an official search URL: {"startUrls":[{"url":"https://www.arbeitsagentur.de/jobsuche/suche?was=Data%20Engineer&wo=Hamburg"}],"maxItems":20}

Pricing

The Actor uses pay-per-event pricing: one low run-start charge plus one result event for each saved job. Check the live Pricing tab for current rates and volume discounts.

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.”

FAQ

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.

Related Actors

• LinkedIn Jobs Scraper
• Indeed Jobs Scraper
• Google Jobs Scraper
• Glassdoor Jobs Scraper
• StepStone Jobs Scraper

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.