https://github.com/andreasfischer1985/entgeltatlas-api
API zum Entgeltatlas der Bundesagentur für Arbeit
https://github.com/andreasfischer1985/entgeltatlas-api
Last synced: 26 days ago
JSON representation
API zum Entgeltatlas der Bundesagentur für Arbeit
- Host: GitHub
- URL: https://github.com/andreasfischer1985/entgeltatlas-api
- Owner: AndreasFischer1985
- Created: 2022-02-15T18:35:25.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-08-01T13:03:12.000Z (almost 2 years ago)
- Last Synced: 2025-03-29T23:22:33.832Z (about 2 months ago)
- Language: Python
- Size: 149 KB
- Stars: 6
- Watchers: 1
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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.
```bash
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:
```bash
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