Nutzung der Jobsuche-API und Anwendungsszenarien für Software-Tools
Nutzung der Jobsuche-API der Bundesagentur für Arbeit (BA)
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
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
| 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
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)
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
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
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
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
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://linux-de.com/?p=21245
