{"id":20711868,"url":"https://github.com/bundesapi/jobsuche-api","last_synced_at":"2025-04-09T15:07:01.601Z","repository":{"id":38398206,"uuid":"389344462","full_name":"bundesAPI/jobsuche-api","owner":"bundesAPI","description":"API zur Bundesagentur für Arbeit Jobsuche ","archived":false,"fork":false,"pushed_at":"2024-08-06T20:33:15.000Z","size":299,"stargazers_count":87,"open_issues_count":21,"forks_count":19,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-04-09T15:06:53.587Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://jobsuche.api.bund.dev/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bundesAPI.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-07-25T12:40:21.000Z","updated_at":"2025-04-07T18:25:08.000Z","dependencies_parsed_at":"2024-08-06T23:38:10.883Z","dependency_job_id":null,"html_url":"https://github.com/bundesAPI/jobsuche-api","commit_stats":{"total_commits":87,"total_committers":11,"mean_commits":7.909090909090909,"dds":0.5632183908045977,"last_synced_commit":"2a6d593081b6eb130721c4b9af98e4a349106c0a"},"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bundesAPI%2Fjobsuche-api","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bundesAPI%2Fjobsuche-api/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bundesAPI%2Fjobsuche-api/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bundesAPI%2Fjobsuche-api/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bundesAPI","download_url":"https://codeload.github.com/bundesAPI/jobsuche-api/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248055284,"owners_count":21040157,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-17T02:17:10.570Z","updated_at":"2025-04-09T15:07:01.568Z","avatar_url":"https://github.com/bundesAPI.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Arbeitsagentur Jobsuche API \nDie 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.\n\n\n## Authentifizierung\nie Authentifizierung funktioniert über die clientId:\n\n**clientId:** jobboerse-jobsuche\n\nBei folgenden GET-requests ist die clientId als Header-Parameter 'X-API-Key' zu übergeben.\n\n\n## Jobbörse\n\n**URL:** https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v4/jobs\n\t\n\nDie Jobsuche ermöglicht verfügbare Jobangebote mit verschiedenen get Parametern zu filtern:\n\n\n### Filter\n\n\n**Parameter:** *was* (Optional)\n\nFreitextsuche Jobtitel (z.B. Referatsleiter).\n\n\n**Parameter:** *wo*  (Optional)\n\nFreitextsuche Beschäftigungsort (z.B. Berlin).\n\n\n**Parameter:** *berufsfeld*  (Optional)\n\nFreitextsuche Berufssfeld (z.B. Informatik).\n\n\n**Parameter:** *page* (Optional)\n\nSeite (beginnend mit 1).\n\n\n**Parameter:** *arbeitgeber* (Optional)\n\nID des Arbeitgebers. z.B. \"Deutsche%20Bahn%20AG\"\n\n\n**Parameter:** *zeitarbeit* (Optional)\n\nGibt an, ob Jobs von Zeitarbeitsfirmen in die Suchergebnisse einbezogen werden sollen (default true).\n\n\n**Parameter:** *size* (Optional)\n\nAnzahl der Ergebnisse\n\n\n**Parameter:** *veroeffentlichtseit* (Optional)\n\nAnzahl der Tage, seit der Job veröffentlicht wurde. Kann zwischen 0 und 100 Tagen liegen.\n\n\n**Parameter:** *pav* (Optional)\n- false \n- true\n\nPrivate Arbeitsvermittlung: Gibt an, ob Jobs von privaten Arbeitsvermittlungen in die Suchergebnisse einbezogen werden sollen.\n\n\n**Parameter:** *angebotsart*  (Optional)\n- 1 \n- 2 \n- 4 \n- 34\n\nAngebotsart: 1=ARBEIT; 2=SELBSTAENDIGKEIT; 4=AUSBILDUNG/Duales Studium; 34=Praktikum/Trainee.\n\n\n**Parameter:** *befristung*  (Optional)\n- 1\n- 2\n\nBefristung: 1 = befristet; 2 = unbefristet. Mehrere Semikolon-separierte Werte möglich (z.B. befristung=1;2).\n\n\nParameter: behinderung (Optional)\n- false \n- true\n\n\nParameter: corona (Optional)\n- false \n- true\n\nCorona: Es werden nur Jobs die im Kontext von Corona angeboten werden angezeigt wenn *true*.\n\n\n**Parameter:** *umkreis* (Optional)\n\nUmkreis: in Kilometern von *Wo*-Parameter (z.B. 25 oder 200).\n\n\n**Parameter:** *arbeitszeit*  (Optional)\n- vz \n- tz \n- snw\n- ho \n- mj \n\nArbeitszeit: vz=VOLLZEIT, tz=TEILZEIT, snw=SCHICHT_NACHTARBEIT_WOCHENENDE, ho=HEIM_TELEARBEIT, mj=MINIJOB. \nMehrere Semikolon-separierte Werte möglich (z.B. arbeitszeit=vz;tz).\n\n\n### Beispiel:\n```bash\njobs=$(curl -m 60 \\\n-H \"X-API-Key: jobboerse-jobsuche\" \\\n'https://rest.arbeitsagentur.de/jobboerse/jobsuche-service/pc/v4/jobs?angebotsart=1\u0026wo=Berlin\u0026umkreis=200\u0026arbeitszeit=ho;mj\u0026page=1\u0026size=25\u0026pav=false')\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbundesapi%2Fjobsuche-api","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbundesapi%2Fjobsuche-api","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbundesapi%2Fjobsuche-api/lists"}