Arbeitsagentur Jobs Scraper — Bundesagentur für Arbeit / Germany Jobsuche

Disclaimer: Unofficial tool for publicly accessible Arbeitsagentur (Bundesagentur für Arbeit) job listings. Bundesagentur für Arbeit, Arbeitsagentur, Jobbörse, and related names are trademarks of their respective owners. Not affiliated with, sponsored by, or endorsed by the Bundesagentur für Arbeit. For informational, research, aggregation, and recruiting-intelligence use only. Respect applicable terms of use and law.

Scrape German job listings from the official Arbeitsagentur / Bundesagentur für Arbeit Jobsuche portal. Search by keyword (was), location (wo), advanced filters, or portal search start URLs. Export structured JSON with title, employer, occupation, address, contract type, salary notes, full description, home-office flags, and external application URLs — fast HTTP Jobsuche API scraping, no headless browser.

Ideal for Germany job board aggregation, labor-market research, recruiting intelligence, employer lead generation, and BA Jobbörse data pipelines.

Key Features

• Arbeitsagentur / BA Jobsuche API — search + job-detail endpoints over HTTP (curl_cffi); no Playwright/Puppeteer
• Germany-wide search — keywords, city/region, radius (km), employer name, occupational field (Berufsfeld)
• Advanced filters — offer type (Arbeit / Ausbildung / Praktikum / Selbständigkeit), fixed-term vs permanent, working time (Vollzeit, Teilzeit, Homeoffice, Minijob, shift)
• Start URL parsing — paste a Jobsuche search URL; query parameters are mapped to API filters automatically
• Full job details — optional detail fetch for complete Stellenbeschreibung and richer metadata
• Deduplicated refnr — unique reference numbers across multi-URL / multi-filter runs
• Low memory — designed for 256–512 MB runs
• Clean camelCase schema — ready for job boards, BI tools, ATS enrichment, and recruiting CRM pipelines
• Apify Proxy ready — DE residential recommended on the Apify platform

Use Cases

Use case	What you get
Job aggregation	Fresh BA / Arbeitsagentur openings into a job board or search index
Labor-market research	Hiring volume by keyword, city, occupation, and contract type in Germany
Recruiting intelligence	Competitor and employer vacancy monitoring by region
Lead generation	Employers actively hiring in a target segment
Salary / contract signals	Salary notes and befristet / unbefristet flags where published
Ausbildung & Praktikum tracking	Filter by offer type for apprenticeships and internships

When to use this Actor

• You need Arbeitsagentur.de / Jobbörse listings as structured data
• You want keyword + location + filter search without a browser
• You need full job descriptions and application links for downstream processing
• You run recurring Germany jobs pulls for dashboards or alerts

When not to use this Actor

• Non-German job portals — this Actor covers Arbeitsagentur / Bundesagentur für Arbeit only
• Guaranteed email or phone — many listings omit direct contacts; use externalApplicationUrl when present
• Historical archives — only currently published Jobsuche results
• Private / authenticated BA services — public Jobsuche listings only

Quick Start

Keyword + city:

{
  "position": "Softwareentwickler",
  "location": "Berlin",
  "maxItems": 50,
  "fetchDetails": true,
  "offerType": "1",
  "radiusKm": 25,
  "workingTime": ["vz", "ho"],
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  }
}

Portal search start URL:

{
  "startUrls": [
    {
      "url": "https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&was=Pflegefachkraft&wo=Muenchen&umkreis=50"
    }
  ],
  "maxItems": 100,
  "fetchDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"],
    "apifyProxyCountry": "DE"
  }
}

Input Parameters

Parameter	Type	Default	Description
position	String	—	Keywords / job title (API was)
location	String	—	City or region (API wo)
startUrls	Array	—	Jobsuche search URLs; query params merge with filters
maxItems	Integer	100	Max jobs (0 = unlimited, subject to portal caps)
fetchDetails	Boolean	true	Fetch full description via job-details endpoint
offerType	String	"1"	1 Arbeit, 2 Selbständigkeit, 4 Ausbildung, 34 Praktikum/Trainee, empty = any
contractType	String	—	1 befristet, 2 unbefristet, 1;2 both
workingTime	Array	[]	vz, tz, snw, ho, mj
radiusKm	Integer	25	Radius in km around location
employer	String	—	Employer name filter
occupationalField	String	—	Berufsfeld free text
publishedWithinDays	Integer	—	Only jobs published in the last N days (0–100)
includeTemporaryAgencies	Boolean	true	When false, excludes Zeitarbeit (zeitarbeit=false)
includePrivatePlacement	Boolean	true	When false, excludes PAV (pav=false)
disabilityFriendly	Boolean	false	Only disability-friendly listings
pageSize	Integer	50	Search page size (1–100)
concurrency	Integer	10	Parallel detail requests
proxyConfiguration	Object	DE residential	Apify Proxy (required on platform for reliable results)

Output Format

Each dataset item is one Arbeitsagentur job listing.

Field	Type	Description
refnr	String	Stellen-Referenznummer
url	String	Public job detail URL
title	String	Job title
description	String	Full description (when fetchDetails is true)
employer	String	Employer / company name
occupation	String	Primary occupation (Hauptberuf)
alternativeOccupations	Array	Related occupation labels
offerType	String	e.g. ARBEIT
contractType	String	e.g. BEFRISTET / UNBEFRISTET
contractMonths	Integer	Fixed-term length in months (if present)
salaryNote	String	Portal salary indicator
publishedAt / modifiedAt / startDate	String	Portal dates
externalApplicationUrl	String	External apply link when provided
homeOfficePossible / homeOfficeType	Boolean / String	Remote-work flags
workingTime	Object	Full-time / part-time / shift flags
location	Object	Address, coordinates, distance
isTemporaryAgency / isPrivatePlacement / isMiniJob	Boolean	Listing flags
searchWas / searchWo	String	Search keywords / location used
scrapedAt	String	ISO timestamp

Output Example

{
  "refnr": "10001-1003353506-S",
  "url": "https://www.arbeitsagentur.de/jobsuche/jobdetail/10001-1003353506-S",
  "title": "Softwareentwickler:in (w/d/m)",
  "employer": "Example Employer GmbH",
  "occupation": "Softwareentwickler/in",
  "offerType": "ARBEIT",
  "contractType": "BEFRISTET",
  "contractMonths": 29,
  "salaryNote": "KEINE_ANGABEN",
  "publishedAt": "2026-07-08",
  "startDate": "2026-07-09",
  "homeOfficePossible": true,
  "homeOfficeType": "NACH_VEREINBARUNG",
  "workingTime": {
    "fullTime": true,
    "partTimeMorning": false,
    "partTimeAfternoon": false,
    "partTimeEvening": false,
    "partTimeFlexible": false,
    "shiftNightWeekend": false
  },
  "location": {
    "street": "Example-Str.",
    "houseNumber": "1",
    "postalCode": "10115",
    "city": "Berlin",
    "region": "BERLIN",
    "country": "DEUTSCHLAND",
    "latitude": 52.52,
    "longitude": 13.40
  },
  "searchWas": "Softwareentwickler",
  "searchWo": "Berlin",
  "scrapedAt": "2026-07-16T10:00:00+00:00"
}

FAQ

Do I need a browser?
No. The Actor uses the public Jobsuche REST search and detail endpoints.

Why enable Apify Proxy?
Platform IPs often receive empty result sets from the Jobsuche API. DE residential proxy is recommended.

Why are descriptions empty?
Keep fetchDetails enabled (default). Search cards alone may omit the full text.

Why did pagination stop near ~250 results?
The portal often caps maxErgebnisse per query. Narrow keywords, location, or filters for more precise slices.

Are email and phone always available?
No. Many listings only expose an external application URL or on-site apply flow.

Zeitarbeit / PAV filters
Set includeTemporaryAgencies or includePrivatePlacement to false to exclude those sources. Leaving both at true uses portal defaults (do not force both API flags to true simultaneously).

Limitations

• Unofficial use of the public Jobsuche API; endpoints may change
• Result volume per query can be capped by the portal
• Salary is often KEINE_ANGABEN — not a structured EUR amount
• Contact fields are frequently absent