Nutzung der Jobsuche-API und Anwendungsszenarien für Software-Tools
Nutzung der Jobsuche-API der Bundesagentur für Arbeit (BA)[Bearbeiten]
Um die Jobsuche-API in eigener Software zu verwenden, muss die technische Authentifizierung über die interne Client-ID der BA erfolgen, da kein offizielles Entwickler-Portal mit individueller Key-Vergabe existiert.
Technische Umsetzung[Bearbeiten]
Die Einbindung erfolgt über eine REST-Schnittstelle. Da die API primär für die Web-Anwendung der BA konzipiert wurde, wird eine statische client-id genutzt.
Basis-URL: https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v4/jobs
Authentifizierung: Erfordert den HTTP-Header X-API-Key.
Standard-Key: jobboerse-jobsuche
Wichtige Query-Parameter[Bearbeiten]
| Parameter | Funktion | Beispiel |
|---|---|---|
| was | Suchbegriff oder Beruf | was=Informatiker |
| wo | Ort oder Postleitzahl | wo=Berlin |
| umkreis | Suchradius in Kilometern | umkreis=20 |
| page | Seitennummer für Ergebnisse | page=1 |
Anwendungsszenarien für Software-Tools[Bearbeiten]
Hier sind drei Konzepte für Anwendungen, die auf Basis dieser API-Daten entwickelt werden könnten:
1. Der "Hidden Gem" Radar (Nischen-Job-Aggregator)[Bearbeiten]
Während kommerzielle Portale oft nur bezahlte Anzeigen priorisieren, enthält die BA-Datenbank nahezu alle gemeldeten Stellen, auch von kleinen Betrieben oder Behörden.
Das Tool: Ein Bot, der die API nach spezifischen, seltenen Schlagwortkombinationen scannt und Nutzer per Push-Benachrichtigung (z. B. Telegram oder Slack) über neue Treffer informiert, die auf großen Plattformen untergehen würden.
2. Regionaler Fachkräfte-Monitor für Kommunen[Bearbeiten]
Entscheidungsträger benötigen oft Echtzeit-Daten zur lokalen Arbeitsmarktsituation.
Das Tool: Ein Dashboard, das die API-Daten aggregiert und auf einer Karte visualisiert. So lässt sich darstellen, in welchen Stadtteilen die Diskrepanz zwischen Gehaltsniveau (Entgeltatlas) und der Anzahl offener Stellen am größten ist.
3. KI-basierter "Skill-Gap" Analysator[Bearbeiten]
Bewerber wissen oft nicht, welche technischen Qualifikationen in ihrer spezifischen Region aktuell den Ausschlag geben.
Das Tool: Eine Anwendung, die per API die Volltext-Beschreibungen der letzten 100 relevanten Stellenanzeigen abruft. Mittels einer KI (LLM) werden die am häufigsten geforderten "Must-have"-Skills extrahiert und mit dem Lebenslauf des Nutzers abgeglichen.
Rechtlicher und technischer Hinweis[Bearbeiten]
Da die Nutzung über eine inoffizielle Client-ID erfolgt, besteht keine Garantie für die dauerhafte Stabilität der Endpunkte. Für hochverfügbare, kommerzielle Anwendungen sollte die offizielle HR-BA-XML Schnittstelle über das Partner-Portal der BA geprüft werden.
Abruf über die Console mit cURL[Bearbeiten]
curl -o jobs.json -H "X-API-Key: jobboerse-jobsuche" "https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v4/jobs?was=Informatiker&wo=Berlin&umkreis=2"
Hilfe zu cURL:
https://hostman.com/de/tutorials/so-laden-sie-dateien-mit-curl-herunter/
