Skip to content

bundesAPI/jobsuche-api

Repository files navigation

Arbeitsagentur Jobsuche API

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.

Authentifizierung

ie Authentifizierung funktioniert über die clientId:

clientId: jobboerse-jobsuche

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

Jobbörse

URL: https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v4/jobs

Die Jobsuche ermöglicht verfügbare Jobangebote mit verschiedenen get Parametern zu filtern:

Filter

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

Beispiel:

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')

About

API zur Bundesagentur für Arbeit Jobsuche

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages