Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/bundesapi/jobsuche-api
API zur Bundesagentur für Arbeit Jobsuche
https://github.com/bundesapi/jobsuche-api
Last synced: 2 days ago
JSON representation
API zur Bundesagentur für Arbeit Jobsuche
- Host: GitHub
- URL: https://github.com/bundesapi/jobsuche-api
- Owner: bundesAPI
- Created: 2021-07-25T12:40:21.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-08-06T20:33:15.000Z (5 months ago)
- Last Synced: 2024-12-13T13:06:40.612Z (9 days ago)
- Language: Python
- Homepage: https://jobsuche.api.bund.dev/
- Size: 292 KB
- Stars: 79
- Watchers: 12
- Forks: 18
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 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:
```bash
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')
```