Skip to content

API zur Bewerberbörse der Bundesagentur für Arbeit

Notifications You must be signed in to change notification settings

AndreasFischer1985/bewerberboerse-api

Repository files navigation

Arbeitsagentur Bewerberbörse API

Die Bundesagentur für Arbeit verfügt über eine der größten Datenbanken für Bewerber*innen 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 über die clientId der Bewerberbörse:

clientId: jobboerse-bewerbersuche-ui

Bei folgenden GET-requests ist die clientId als Header-Parameter 'X-API-Key' zu übergeben.

Bewerbendenbörse

URL: https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerber

Die Bewerberbörse ermöglicht es, Bewerber*innen mit verschiedenen GET-Parametern zu filtern.

Parameter: was (Optional)

Beruf, Kenntnisse, Sprachen, etc.

Parameter: ausbildungsart (Optional)

  • au
  • dsa
  • dsp

Ausbildungsart: au=Ausbildung, dsa=Duales Studium (ausbildungsintegrierend), dsp=Duales Studium (praxisintegrierend).

Parameter: wo (Optional)

Ort, PLZ, Bundesland, Land, etc.

Parameter: umkreis (Optional)

  • 0
  • 10
  • 15
  • 20
  • 50
  • 100
  • 200

Umkreis: 0=ganzer Ort; 10=10km; 15=15km; 20=20km; 50=50km; 100=100km; 200=200km.

Parameter: angebotsart (Optional)

  • ar
  • au
  • pt
  • se

Angebotsart: ar=Arbeitskräfte; au=Auszubildende/Duales Studium; pt=Praktikanten/Trainees; se=Selbstständige.

Parameter: arbeitszeit (Optional)

  • vz
  • tz
  • snw

Arbeitszeit: vz=Vollzeit; tz=Teilzeit; snw=Schicht,Nacht,Wochenende; ht=Heim-/Telearbeit; mj=Minijob.

Parameter: berufserfahrung (Optional)

  • be
  • mb

Berufserfahrung: be=Berufseinsteiger*innen; mb=Mit Berufserfahrung.

Vertragsart: vertragsart (Optional)

  • be
  • ub

Vertragsart: be=Befristet; ub=Unbefristet.

Parameter: behinderung (Optional)

  • an

Behinderung: an=Nur Schwerbehinderte oder ihnen gleichgestellte Bewerber*innen anzeigen.

Parameter: page (Optional)

Seite (beginnend bei 0).

Parameter: size (Optional)

Anzahl der Ergebnisse

Beispiel:

bewerbende=$(curl -m 60 \
-H "X-API-Key: jobboerse-bewerbersuche-ui" \
'https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerber?angebotsart=ar&wo=Feucht&umkreis=0&page=0&size=25')

Bewerbendendetails

URL: https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerberdetails/{Referenznummer}

Details zu einzelnen Bewerbenden lassen sich unter Angabe der Referenznummer (z.B. 10005-955011998040991647-B) abfragen, u.a. Bildungshistorie, beruflicher Werdegang, Lizenzen, Kenntnisse & Skills.

Beispiel:

bewerbendendetails=$(curl -m 60 \
-H "X-API-Key: jobboerse-bewerbersuche-ui" \
'https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerberdetails/10005-955011998040991647-B')

About

API zur Bewerberbörse der Bundesagentur für Arbeit

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages