{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Jobs Scraper (Germany)", "description": "Scrape jobs from arbeitsagentur.de, Germany's largest job board. Filter remote / home office jobs and professional fields like IT. Get title, company, city, salary and contract type. Fast, no proxy, no personal data.", "version": "0.1", "x-build-id": "WcfR8yAhFee3I2Bo7" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/bircolabots~arbeitsagentur-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-bircolabots-arbeitsagentur-jobs", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/bircolabots~arbeitsagentur-jobs/runs": { "post": { "operationId": "runs-sync-bircolabots-arbeitsagentur-jobs", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/bircolabots~arbeitsagentur-jobs/run-sync": { "post": { "operationId": "run-sync-bircolabots-arbeitsagentur-jobs", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keyword": { "title": "Keyword", "type": "string", "description": "Job title, occupation or skill to search for (German or English), e.g. \"Softwareentwickler\" or \"python\". Leave empty to get all jobs." }, "location": { "title": "Location", "type": "string", "description": "City or postal code in Germany, e.g. \"Berlin\", \"München\" or \"80331\". Leave empty for the whole country." }, "radiusKm": { "title": "Radius around the location", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius around the location. Only used when a location is set.", "default": 25 }, "extraKeywords": { "title": "More keywords (optional)", "type": "array", "description": "Search several keywords in one run, e.g. \"java\" and \"devops\". Combined with every location; the same job is saved only once.", "items": { "type": "string" } }, "extraLocations": { "title": "More locations (optional)", "type": "array", "description": "Search several cities or postal codes in one run, e.g. \"Hamburg\" and \"München\". Up to 50 keyword × location combinations per run.", "items": { "type": "string" } }, "publishedWithinDays": { "title": "Published within the last N days", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only return jobs published in the last N days. Leave empty for no date filter." }, "remoteOnly": { "title": "Only remote / home office jobs", "type": "boolean", "description": "Keep only jobs where the employer allows home office. The official home office filter of the job board does not work, so the Actor checks each job itself (about 1 in 10 jobs qualifies).", "default": false }, "professionalFields": { "title": "Professional field (Berufsfeld)", "type": "array", "description": "Official occupational fields of the Bundesagentur für Arbeit. Pick one or more, e.g. \"Informatik\" and \"Softwareentwicklung und Programmierung\" for IT jobs, or \"Krankenpflege, Rettungsdienst und Geburtshilfe\" for nursing.", "items": { "type": "string", "enum": [ "Altenpflege", "Angehörige der regulären Streitkräfte in sonstigen Rängen", "Angehörige gesetzgebender Körperschaften", "Arzt- und Praxishilfe", "Aus- und Trockenbau, Isolierung, Zimmerei, Glaserei", "Bau- und Transportgeräteführung", "Bauplanung und -überwachung, Architektur", "Berg-, Tagebau und Sprengtechnik", "Bestattungswesen", "Biologie", "Bodenverlegung", "Buch- und Kunstantiquitäten, Musikfachhandel", "Bühnen- und Kostümbildnerei, Requisite", "Büro und Sekretariat", "Chemie", "Drucktechnik, Buchbinderei", "Einkauf und Vertrieb", "Elektrotechnik", "Energietechnik", "Ernährungs- und Gesundheitsberatung", "Erziehung, Sozialarbeit, Heilerziehungspflege", "Fahr- und Sportunterricht an außerschulischen Bildungseinrichtungen", "Fahrzeug-, Luft-, Raumfahrt- und Schiffbautechnik", "Fahrzeugführung im Eisenbahnverkehr", "Fahrzeugführung im Flugverkehr", "Fahrzeugführung im Schiffsverkehr", "Fahrzeugführung im Straßenverkehr", "Farb- und Lacktechnik", "Feinwerk- und Werkzeugtechnik", "Fischwirtschaft", "Floristik", "Forstwirtschaft, Jagdwirtschaft, Landschaftspflege", "Fototechnik und Fotografie", "Gartenbau", "Gastronomie", "Gebäudetechnik", "Geisteswissenschaften", "Geologie, Geografie und Meteorologie", "Geschäftsführung und Vorstand", "Gesellschaftswissenschaften", "Getränkeherstellung", "Gewerbe, Gesundheitsaufsicht, Desinfektion", "Handel", "Hauswirtschaft und Verbraucherberatung", "Hochbau", "Holzbe- und -verarbeitung", "Hotellerie", "Human- und Zahnmedizin", "Immobilienwirtschaft und Facility-Management", "Industrielle Glasherstellung", "Industrielle Keramikherstellung", "Informatik", "Innenarchitektur, Raumausstattung", "IT-Netzwerktechnik, -Administration, -Organisation", "IT-Systemanalyse, -Anwendungsberatung und -Vertrieb", "Kaufleute - Verkehr und Logistik", "Klempnerei, Sanitär-, Heizungs- und Klimatechnik", "Krankenpflege, Rettungsdienst und Geburtshilfe", "Kunsthandwerk und bildende Kunst", "Kunsthandwerkliche Keramik- und Glasgestaltung", "Kunsthandwerkliche Metallgestaltung", "Kunststoff- und Kautschukherstellung", "Körperpflege", "Lagerwirtschaft, Post und Zustellung, Güterumschlag", "Landwirtschaft", "Lebensmittel- und Genussmittelherstellung", "Leder- und Pelzherstellung", "Lehr- und Forschungstätigkeit an Hochschulen", "Lehrtätigkeit an allgemeinbildenden Schulen", "Lehrtätigkeit an außerschulischen Bildungseinrichtungen", "Lehrtätigkeit berufsbildender Fächer und betriebliche Ausbildung", "Maler, Stuckateure, Bautenschutz", "Maschinenbau- und Betriebstechnik", "Mathematik und Statistik", "Mechatronik und Automatisierungstechnik", "Medien-, Dokumentations- und Informationsdienste", "Medizin-, Orthopädie- und Rehatechnik", "Medizinisches Laboratorium", "Metallbau und Schweißtechnik", "Metallbearbeitung", "Metallerzeugung", "Metalloberflächenbehandlung", "Moderation und Unterhaltung", "Museumstechnik und -management", "Musik-, Gesang-, Dirigententätigkeiten", "Musikinstrumentenbau", "Naturstein- und Mineralaufbereitung, Baustoffherstellung", "Nichtärztliche Therapie und Heilkunde", "Objekt-, Personen-, Brandschutz, Arbeitssicherheit", "Offiziere", "Papier- und Verpackungstechnik", "Personalwesen und -dienstleistung", "Pferdewirtschaft", "Pharmazie", "Physik", "Polizei- und Kriminaldienst, Gerichts- und Justizvollzug", "Produkt- und Industriedesign", "Psychologie, nichtärztliche Psychotherapie", "Rechnungswesen, Controlling und Revision", "Rechtsberatung, -sprechung und -ordnung", "Redaktion und Journalismus", "Reinigung", "Schauspiel, Tanz und Bewegungskunst", "Servicekräfte im Personenverkehr", "Softwareentwicklung und Programmierung", "Speisenzubereitung", "Sprach- und Literaturwissenschaften", "Steuerberatung", "Technische Forschung und Entwicklung", "Technische Mediengestaltung", "Technische Produktionsplanung und -steuerung", "Technischer Betrieb des Eisenbahn-, Luft- und Schiffsverkehrs", "Technisches Zeichnen, Konstruktion und Modellbau", "Textiltechnik und -produktion", "Textilverarbeitung", "Theater-, Film- und Fernsehproduktion", "Theologie und Gemeindearbeit", "Tiefbau", "Tiermedizin und Tierheilkunde", "Tierpflege", "Tierwirtschaft", "Tourismus und Sport", "Umweltmanagement und -beratung", "Umweltschutztechnik", "Unternehmensorganisation und -strategie", "Unteroffiziere mit Portepee", "Unteroffiziere ohne Portepee", "Ver- und Entsorgung", "Veranstaltungs-, Kamera-, Tontechnik", "Veranstaltungsservice und -management", "Verkauf (ohne Produktspezialisierung)", "Verkauf Bekleidung, Elektro, KFZ, Hartwaren", "Verkauf von drogerie- und apothekenüblichen Waren", "Verkauf von Lebensmitteln", "Verlags- und Medienwirtschaft", "Vermessung und Kartografie", "Versicherungs- und Finanzdienstleistungen", "Verwaltung", "Weinbau", "Werbung und Marketing", "Wirtschaftswissenschaften", "Öffentlichkeitsarbeit", "Überwachung und Steuerung des Verkehrsbetriebs", "Überwachung, Wartung Verkehrsinfrastruktur" ] } }, "offerType": { "title": "Offer type", "enum": [ "1", "2", "4", "34" ], "type": "string", "description": "Type of offer to return.", "default": "1" }, "workingTime": { "title": "Working time", "enum": [ "any", "vz", "tz", "snw", "mj" ], "type": "string", "description": "Filter by working time.", "default": "any" }, "contractType": { "title": "Contract type", "enum": [ "any", "permanent", "fixedTerm" ], "type": "string", "description": "Permanent or fixed-term contracts.", "default": "any" }, "employer": { "title": "Employer", "type": "string", "description": "Only jobs from this employer. Use the exact company name as shown on arbeitsagentur.de, e.g. \"Deutsche Bahn AG\" (partial names return no results)." }, "careerChangersOnly": { "title": "Only jobs open to career changers (Quereinstieg)", "type": "boolean", "description": "Keep only jobs the employer marks as suitable for career changers.", "default": false }, "excludeTempAgencies": { "title": "Exclude temporary work agencies (Zeitarbeit)", "type": "boolean", "description": "Skip listings posted by temporary employment agencies (Zeitarbeit).", "default": false }, "excludePrivateAgencies": { "title": "Exclude private recruitment agencies", "type": "boolean", "description": "Skip listings posted by private employment agencies (private Arbeitsvermittlung).", "default": false }, "maxItems": { "title": "Maximum number of jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many jobs. You pay per job saved, so this also caps the cost. The source returns at most 10,000 results per search; split the search by city or keyword to go deeper.", "default": 100 } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }