Die Bundesagentur für Arbeit verfügt über die größte Datenbank für offene Stellen 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.
ie Authentifizierung funktioniert über die clientId:
clientId: jobboerse-jobsuche
Bei folgenden GET-requests ist die clientId als Header-Parameter 'X-API-Key' zu übergeben.
URL: https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v4/jobs
Die Jobsuche ermöglicht verfügbare Jobangebote mit verschiedenen get Parametern zu filtern:
Parameter: was (Optional)
Freitextsuche Jobtitel (z.B. Referatsleiter).
Parameter: wo (Optional)
Freitextsuche Beschäftigungsort (z.B. Berlin).
Parameter: berufsfeld (Optional)
Freitextsuche Berufssfeld (z.B. Informatik).
Parameter: page (Optional)
Seite (beginnend mit 1).
Parameter: arbeitgeber (Optional)
ID des Arbeitgebers. z.B. "Deutsche%20Bahn%20AG"
Parameter: zeitarbeit (Optional)
Gibt an, ob Jobs von Zeitarbeitsfirmen in die Suchergebnisse einbezogen werden sollen (default true).
Parameter: size (Optional)
Anzahl der Ergebnisse
Parameter: veroeffentlichtseit (Optional)
Anzahl der Tage, seit der Job veröffentlicht wurde. Kann zwischen 0 und 100 Tagen liegen.
Parameter: pav (Optional)
- false
- true
Private Arbeitsvermittlung: Gibt an, ob Jobs von privaten Arbeitsvermittlungen in die Suchergebnisse einbezogen werden sollen.
Parameter: angebotsart (Optional)
- 1
- 2
- 4
- 34
Angebotsart: 1=ARBEIT; 2=SELBSTAENDIGKEIT; 4=AUSBILDUNG/Duales Studium; 34=Praktikum/Trainee.
Parameter: befristung (Optional)
- 1
- 2
Befristung: 1 = befristet; 2 = unbefristet. Mehrere Semikolon-separierte Werte möglich (z.B. befristung=1;2).
Parameter: behinderung (Optional)
- false
- true
Parameter: corona (Optional)
- false
- true
Corona: Es werden nur Jobs die im Kontext von Corona angeboten werden angezeigt wenn true.
Parameter: umkreis (Optional)
Umkreis: in Kilometern von Wo-Parameter (z.B. 25 oder 200).
Parameter: arbeitszeit (Optional)
- vz
- tz
- snw
- ho
- mj
Arbeitszeit: vz=VOLLZEIT, tz=TEILZEIT, snw=SCHICHT_NACHTARBEIT_WOCHENENDE, ho=HEIM_TELEARBEIT, mj=MINIJOB. Mehrere Semikolon-separierte Werte möglich (z.B. arbeitszeit=vz;tz).
jobs=$(curl -m 60 \
-H "X-API-Key: jobboerse-jobsuche" \
'https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v4/jobs?angebotsart=1&wo=Berlin&umkreis=200&arbeitszeit=ho;mj&page=1&size=25&pav=false')