https://github.com/andreasfischer1985/bewerberboerse-api
API zur Bewerberbörse der Bundesagentur für Arbeit
https://github.com/andreasfischer1985/bewerberboerse-api
Last synced: 26 days ago
JSON representation
API zur Bewerberbörse der Bundesagentur für Arbeit
- Host: GitHub
- URL: https://github.com/andreasfischer1985/bewerberboerse-api
- Owner: AndreasFischer1985
- Created: 2022-08-29T19:53:23.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-08-11T16:02:03.000Z (9 months ago)
- Last Synced: 2025-03-29T23:22:43.392Z (about 2 months ago)
- Language: Python
- Size: 80.1 KB
- Stars: 3
- Watchers: 3
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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:
```bash
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:
```bash
bewerbendendetails=$(curl -m 60 \
-H "X-API-Key: jobboerse-bewerbersuche-ui" \
'https://rest.arbeitsagentur.de/jobboerse/bewerbersuche-service/pc/v1/bewerberdetails/10005-955011998040991647-B')
```