Jobs — entry 004 of 18
Arbeitsamt
The Bundesagentur für Arbeit's Jobsuche API is Germany's official public job-search service, covering listings, employer details, and application document references. Every request needs the fixed public clientId sent as an X-API-Key header rather than a per-user OAuth token, and returns JSON.
The Bundesagentur fur Arbeit's Jobsuche API is Germany's official public job-search service. Its live OpenAPI spec (jobsuche.api.bund.dev/openapi.yaml, enumerated this run) documents a two-step flow: search via /pc/v6/jobs (or /pc/v4/app/jobs) to get a job's refnr, then fetch the full record via /pc/v4/jobdetails/{base64(refnr)}.
AuthenticationAPI KeySign up with the provider to obtain credentials.
HTTPSSupportedTraffic is encrypted in transit.
CORSDisabledBrowser calls need a server-side proxy.
PricingFreeNo paid tier — free for the documented use case.
FormatsJSONResponses can be requested as JSON.
GreatAPIs Score
Score84
Authentication15/25API key required
Pricing20/20Free to use
Docs20/20Machine-readable spec file bundled
Formats9/15Single response format
Freshness20/20Verified within 6 months
Embed this badge
<a href="https://greatapis.com/api/arbeitsamt/"><img src="https://greatapis.com/badge/arbeitsamt.svg" alt="Scored 84 on greatapis.com"></a>Auth quickstart
- Every request needs the fixed public clientId sent as an
X-API-Key: jobboerse-jobsucheheader — confirmed live this run: the same search query returns403with a 1-byte body without the header and a real200with job data once it's supplied. This value is a documented public constant in the project's own OpenAPI spec, not a secret.
Stored keyNo key stored
Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.
Endpoints
ct1
GET/ct/v1/arbeitgeberlogo/{kundennummerHash}Unternehmen Logo
Parameters
| Name | In | Required | Type |
|---|---|---|---|
kundennummerHash | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | — |
404 | Kein Logo für diesen Arbeitgeber vorhanden. | — |
pc4
GET/pc/v3/jobdetails/{encryptedJobCode}Jobdetails (v3)
Parameters
| Name | In | Required | Type |
|---|---|---|---|
encryptedJobCode | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | JobDetails |
GET/pc/v4/app/jobsJobsuche via App
Parameters
| Name | In | Required | Type |
|---|---|---|---|
was | query | no | string |
wo | query | no | string |
berufsfeld | query | no | string |
page | query | no | integer |
size | query | no | integer |
arbeitgeber | query | no | string |
veroeffentlichtseit | query | no | integer |
zeitarbeit | query | no | boolean |
angebotsart | query | no | integer |
befristung | query | no | integer |
arbeitszeit | query | no | string |
behinderung | query | no | boolean |
corona | query | no | boolean |
umkreis | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | JobSearchResponse |
GET/pc/v4/jobdetails/{encryptedJobCode}Jobdetails (v4)
Parameters
| Name | In | Required | Type |
|---|---|---|---|
encryptedJobCode | path | yes | string |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | JobDetails |
GET/pc/v6/jobsJobsuche
Parameters
| Name | In | Required | Type |
|---|---|---|---|
was | query | no | string |
wo | query | no | string |
berufsfeld | query | no | string |
page | query | no | integer |
size | query | no | integer |
arbeitgeber | query | no | string |
veroeffentlichtseit | query | no | integer |
zeitarbeit | query | no | boolean |
angebotsart | query | no | integer |
befristung | query | no | integer |
arbeitszeit | query | no | string |
behinderung | query | no | boolean |
corona | query | no | boolean |
umkreis | query | no | integer |
Responses
| Status | Description | Schema |
|---|---|---|
200 | OK | JobSearchResponse |
Try it
Developer reference
Base URL
https://rest.arbeitsagentur.de/jobboerse/jobsuche-serviceKey endpoints
- GET/pc/v6/jobs
- GET/pc/v4/jobdetails/{encryptedJobCode}
Gotchas & limits
- The job-detail path takes the refnr base64-encoded, not raw: confirmed live,
GET .../pc/v4/jobdetails/10000-1207221816-S(unencoded) 404s with a real JSON body{"messages":[{"code":"STELLENANGEBOT_NICHT_GEFUNDEN"}], ...}, while the base64 form of the identical refnr succeeds. - The spec's own documented flow uses /pc/v6/jobs for search (richer, deeply-nested field names like
ergebnisliste/referenznummer/stellenlokationen) and /pc/v4/jobdetails for the detail lookup — but the older, undocumented /pc/v4/jobs search endpoint (simpler flat names:stellenangebote/refnr) still returns real 200 results too, confirmed live this run; the two search shapes are not interchangeable field-for-field. - An older /pc/v2/jobdetails/{base64(refnr)} path (referenced in older third-party write-ups) now returns a bare
403with a 1-byte body even with a valid key and correctly base64-encoded refnr — it's gone, not merely deprecated-but-working. /pc/v3/jobdetails and /pc/v4/jobdetails both still work for the same refnr and return byte-identical bodies (confirmed live this run); the spec calls v4 the "recommended version." - CORS is closed: confirmed live with no
access-control-allow-originheader on the search endpoint, neither bare nor with anOriginheader, and an OPTIONS preflight (Access-Control-Request-Method: GET) succeeds withAllow: GET, HEAD, OPTIONSbut still no CORS header — a preflight-shaped 200 that a browser would still block. - No rate limit is documented anywhere in the live spec (jobsuche.api.bund.dev/openapi.yaml has zero mentions of "limit"/"throttle"/"quota") and none was observed in response headers this run — unlike ai-dev-jobs or The Muse, there is nothing to report here.
Changelog
Spec version2.1.0
Tracked paths5
- gained an OpenAPI spec