Arbeitsagentur Ausbildungssuche API

Die Bundesagentur für Arbeit verfügt über eine der größten Datenbanken für Ausbildungsangebote 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 beispielsweise einem GET-request an https://web.arbeitsagentur.de/ausbildungssuche/berufsausbildung-suche zu entnehmen ist (oder an https://web.arbeitsagentur.de/ausbildungssuche/schulabschluss-suche, an https://web.arbeitsagentur.de/ausbildungssuche/vorbereitende-hilfen-suche, oder an https://web.arbeitsagentur.de/ausbildungssuche/begleitende-hilfen-suche), folgende:

client_id: 1c852184-1944-4a9e-a093-5cc078981294

client_secret: 777f9915-9f0d-4982-9c33-07b5810a3e79

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=1c852184-1944-4a9e-a093-5cc078981294&client_secret=777f9915-9f0d-4982-9c33-07b5810a3e79&grant_type=client_credentials" \
-X POST 'https://rest.arbeitsagentur.de/oauth/gettoken_cc' |grep -Eo '[^"]{500,}'|head -n 1)

Der generierte Token muss bei folgenden GET-requests an https://rest.arbeitsagentur.de/infosysbub/absuche/pc/v1/ausbildungsangebot im header als 'OAuthAccessToken' inkludiert werden.

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

Ausbildungssuche

URL: https://rest.arbeitsagentur.de/infosysbub/absuche/pc/v1/ausbildungsangebot

Die Ausbildungssuche ermöglicht verfügbare Angebote mit dem Ziel einer Berufsausbildung, Schulabschluss, Ausbildungsvorbereitung oder -begleitung mit verschiedenen GET-Parametern zu filtern:

Filter

Parameter: sty (Optional)

• 0
• 1
• 2
• 3
• 4

sty: 0=Berufsausbildung; 1=Schulabschluss; 2=Vorbereitung auf Aus- und Weiterbildung oder berufliche Tätigkeit; 3=Begleitende Hilfen; 4=Alle.

Parameter: ids (Optional)

Berufs-ID einer Berufsbezeichnung (z.B. 2927 für IT-System-Elektroniker/innen). Mehrere Komma-getrennte Angaben möglich.

Parameter: orte (Optional)

ID für Orte (z.B. 38450 für den Ort Feucht). Mehrere Komma-getrennte Angaben möglich.

Parameter: page (Optional)

Seite (beginnend mit 0).

Parameter: size (Optional)

Anzahl der Ergebnisse pro Seite (maximal 2000). Insgesamt werden über alle Seiten hinweg maximal 10000 Ergebnisse angezeigt.

Parameter: uk (Optional)

• Bundesweit
• 25
• 50
• 100
• 150
• 200

Umkreis: Bundesweit=Bundesweit, 25=25 km, 50=50 km, 100=100 km, 150=150 km, 200=200 km.

Parameter: re (Optional)

• BAW
• BAY
• BER
• BRA
• BRE
• HAM
• HES
• MBV
• NDS
• NRW
• RPF
• SAA
• SAC
• SAN
• SLH
• TH%C3%9C
• "-"

Region/Bundesland: BAW=Bade-Württemberg, BAY=Bayern, BER=Berlin, BRA=Brandenburg, BRE=Bremen, HAM=Hamburg, HES=Hessen, MBV=Mecklenburg-Vorpommern, NDS=Niedersachsen, NRW=Nordrhein-Westfalen, RPF=Rheinland-Pfalz, SAA=Saarland, SAC=Sachsen, SAN=Sachsen-Anhalt, SLH=Schleswig-Holstein, TH%C3%9C=Thüringen, -=überregional. Mehrere Komma-getrennte Angaben möglich (z.B. re=TH%C3%9C,BAW).

Parameter: bt (Optional)

• 2
• 101
• 102
• 103
• 104
• 105
• 106
• 107
• 108
• 109
• 110
• 111
• 112

Beginntermin: 2=frühere Termine, 101=Januar des Folgejahres, 102=Februar des Folgejahres, 103=März des Folgejahres, 104=April des Folgejahres, 105=Mai des Folgejahres, 106=Juni des Folgejahres, 107=Juli des Folgejahres, 108=August des Folgejahres, 109=September des Folgejahres, 110=Oktober des Folgejahres, 111=November des Folgejahres, 112=Dezember des Folgejahres. Mehrere Komma-getrennte Angaben möglich.

Parameter: bart (Optional)

• 0
• 100
• 101
• 102
• 103
• 104
• 105
• 106
• 107108
• 109

Ausbildungstyp: 0=Keine Zuordnung möglich, 100=Allgemeinbildung, 101=Teilqualifizierung, 102=Berufsausbildung, 103=Gesetzlich/gesetzesähnlich geregelte Fortbildung/Qualifizierung, 104=Fortbildung/Qualifizierung, 105=Abschluss nachholen, 106=Rehabilitation, 107108=Studienangebot - grundständig, 109=Umschulung

Parameter: ityp (Optional)

• 1
• 2

Integrationstyp: 0=Ausbildung Reha, 1=weiterbildung Reha. Mehrere Komma-getrennte Angaben möglich (z.B. ityp=0,1).

Parameter: ban (Optional) Bildungsanbieter-ID (z.B. 465).

Parameter: bg (Optional)

• true
• false

Bildungsgutschein: true=nur Angebote mit Zulassung zur Förderung mit Bildungsgutschein anzeigen, false=nicht nur Angebote mit Zulassung zur Förderung mit Bildungsgutschein anzeigen.

Beispiel:

wb=$(curl -m 60 \
-H "OAuthAccessToken: $token" \
'https://rest.arbeitsagentur.de/infosysbub/absuche/pc/v1/ausbildungsangebot?bart=101&sty=0')