Arbeitsagentur Entgeltaltas API

Die Bundesagentur für Arbeit verfügt über eine Datenbank zu Entgelten für unterschiedliche Berufstätigkeiten in Deutschland. Obwohl sie vollständig staatlich ist und es sich dabei um einen sehr spannenden Basisdatensatz handelt, mit dem viele Analysen möglich wären, bietet die Bundesagentur für Arbeit dafür bis heute keine offizielle API an.

Authentifizierung

Die Authentifizierung funktioniert per OAuth 2 Client Credentials mit JWTs. Client Credentials sind, wie sich z.B: einem GET-request an https://web.arbeitsagentur.de/entgeltatlas/ entnehmen lässt, folgende:

client_id: c4f0d292-9d0f-4763-87dd-d3f9e78fb006

client_secret: 566c4dd6-942f-4cda-aad6-8d611c577107

grant_type: client_credentials

Die Credentials sind im body eines POST-request an https://rest.arbeitsagentur.de/oauth/gettoken_cc zu senden.

token=$(curl \
-d "client_id=c4f0d292-9d0f-4763-87dd-d3f9e78fb006&client_secret=566c4dd6-942f-4cda-aad6-8d611c577107&grant_type=client_credentials" \
-X POST 'https://rest.arbeitsagentur.de/oauth/gettoken_cc' |grep -Eo '[^"]{400,}'|head -n 1)

Der generierte Token muss bei folgenden GET-requests an https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/entgelte/[KldB-Schlüssel] im header als 'OAuthAccessToken' inkludiert werden.

KldB meint in diesem Fall die Klassifikation der Berufe 2010. Akzeptiert werden KldB-Schlüssel mit 3 bis 5 Ziffern. Beispielsweise repräsentiert der KldB-Schlüssel 84304 "Berufe in der Hochschullehre und -forschung - hoch komplexe Tätigkeiten" (wie man z.B. hier nachschlagen kann: https://www.klassifikationsserver.de/klassService/jsp/common/url.jsf?item=8430&variant=kldb2010&detail=true - verifizieren lässt sich die Bedeutung der KldB-Nummer auch über eine Anfrage mit Token an https://rest.arbeitsagentur.de/infosysbub/dkz-rest/pc/v1//kldb2010?codenr=B%2084304 ).

Hinweis: Alternativ kann man bei folgenden GET-requests auch direkt die client_id als Header-Parameter 'X-API-Key' übergeben - 'OAuthAccessToken' ist in diesem Fall nicht erforderlich. 🚀

Entgeltatlas

URL: https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/entgelte/[KldB-Schlüssel]

Der Entgeltatlas ermöglicht, das Entgelt für verschiedene Berufstätigkeiten mit verschiedenen GET-Parametern zu filtern:

Filter

Parameter: l (Optional)

• 1
• 2
• 3
• 4

performance-level: 1=Helfer; 2=Fachkraft; 3=Spezialist 4=Experte.

Parameter: r (Optional)

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11
• 12
• 13
• 14
• 15
• 16
• 17
• 18
• 19
• 20
• 21
• 22
• 23
• 24
• 25
• 26
• 27
• 28
• 29
• 30

region: 1=Deutschland; 2=Ostdeutschland; 3=Westdeutschland; 11=BaWü; 12=Bayern; 14=Berlin; 15=Brandenburg; 7=Bremen; 5=Hamburg; 9=Hessen; 16=Mecklenburg-Vorpommern; 6=Niedersachsen; 8=Nordrhein-Westfalen; 10=Rheinland-Pfalz; 13=Saarland; 17=Sachsen; 18=Sachsen-Anhalt; 4=Schleswig-Holstein; 19=Thüringen; 22=Dortmund; 20=Dresden; 21=Düsseldorf; 23=Essen; 24=Frankfurt am Main; 26=Hannover; 27=Köln; 28=Leipzig; 29=München; 25=Nürnberg; 30=Stuttgart (vgl. https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/regionen).

Parameter: g (Optional)

• 1
• 2
• 3

Geschlecht: 1=Gesamt, 2=Männer, 3=Frauen (vgl. https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/geschlechter).

Parameter: a (Optional)

• 1
• 2
• 3
• 4

Alter: 1=Gesamt; 2=unter 25; 3=25 bis unter 55; 4=ab 55 (vgl. https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/alter).

Parameter: b (Optional)

• 1
• 2
• 3
• 4
• 5
• 6
• 7
• 8
• 9
• 10
• 11

Branche: 1=Gesamt; 2=Land- und Forstwirtschaft, Fischerei; 3=produzierendes Gewerbe ohne Bau; 4=Baugewerbe; 5=Handel, Verkehr, Lagerei und Gastgewerbe; 6=Information und Kommunikation; 7=Finanz- und Verischerungsgewerbe; 8=Grundstücks- und Wohnungswesen; 9=Erbringung wirtschaftl. Dienstleistungen; 10=Öffentliche Verwaltung, schul-, Gesundheits-, Sozialwesen; 11=sonstige Dienstleistungen (vgl. https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/branchen).

Beispiel:

wb=$(curl -m 60 \
-H "OAuthAccessToken: $token" \
'https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/entgelte/84304?l=4&r=1&a=1&b=1')

Weitere Endpunkte

• https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/mediandaten (mit GET-Parameter dkzIds, z.B. 77878 - potenziell mehrere, durch Kommata getrennt)
• https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/ct/v1/primaerer-median/77878
• https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/regionen
• https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/geschlechter
• https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/alter
• https://rest.arbeitsagentur.de/infosysbub/entgeltatlas/pc/v1/branchen