{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur.de - Job Scraper, Bundesagentur für Arbeit", "description": "Fast, browser-free scraper for German job and Ausbildung listings from arbeitsagentur.de via internal web API. Solves captchas automatically, uses own proxies(zero proxy charge), and returns full company and contact details alongside each ad — the most complete dataset available for this source.", "version": "0.1", "x-build-id": "4dfFgNbT7oi6qEme2" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mof1re~arbeitsagentur-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mof1re-arbeitsagentur-scraper", "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/mof1re~arbeitsagentur-scraper/runs": { "post": { "operationId": "runs-sync-mof1re-arbeitsagentur-scraper", "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/mof1re~arbeitsagentur-scraper/run-sync": { "post": { "operationId": "run-sync-mof1re-arbeitsagentur-scraper", "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", "required": [ "query" ], "properties": { "query": { "title": "Search query", "type": "string", "description": "Job title / keyword to search for (was= param)", "default": "" }, "cities": { "title": "Cities", "type": "array", "description": "Pick one or more cities. Sent to the API joined with ';' as arbeitsort=City1;City2", "items": { "type": "string", "enum": [ "Berlin", "Hamburg", "München", "Köln", "Düsseldorf", "Nürnberg, Mittelfranken", "Stuttgart", "Bremen", "Dortmund", "Hannover", "Frankfurt am Main", "Essen, Ruhr", "Duisburg", "Karlsruhe, Baden", "Münster, Westfalen", "Dresden", "Bochum", "Mönchengladbach", "Leipzig", "Mannheim", "Würzburg", "Aachen", "Bielefeld", "Lübeck", "Freiburg im Breisgau", "Augsburg, Bayern", "Ulm, Donau", "Wuppertal", "Heilbronn, Neckar", "Regensburg", "Osnabrück", "Kiel", "Braunschweig", "Bonn", "Aalen, Württemberg", "Oldenburg (Oldb)", "Krefeld", "Kassel, Hessen", "Trier", "Weiden in der Oberpfalz", "Gelsenkirchen", "Hamm, Westfalen", "Paderborn", "Heidelberg, Neckar", "Memmingen", "Ingolstadt, Danube", "Saarbrücken", "Magdeburg", "Reutlingen", "Hagen, Westphalia", "Oberhausen, Rheinland", "Koblenz am Rhein", "Chemnitz, Saxony", "Bocholt", "Mülheim an der Ruhr", "Siegen", "Ludwigshafen am Rhein", "Esslingen am Neckar", "Fulda", "Straubing", "Pforzheim", "Bremerhaven", "Erfurt", "Bayreuth", "Gera", "Baden-Baden", "Fürth, Bayern", "Schweinfurt", "Rheine", "Kempten (Allgäu)", "Mainz am Rhein", "Offenburg", "Göppingen", "Herne, Westphalia", "Bamberg", "Papenburg", "Wiesbaden", "Passau", "Erlangen", "Halle (Saale)", "Neuss", "Lingen (Ems)", "Potsdam", "Rostock", "Nördlingen", "Arnsberg, Westfalen", "Villingen-Schwenningen", "Darmstadt", "Melle, Wiehengebirge", "Gießen, Lahn", "Neumünster, Holstein", "Lüneburg", "Nordhorn", "Marburg", "Neu-Ulm", "Schwerin, Mecklenburg", "Rosenheim, Upper Bavaria", "Flensburg", "Detmold", "Recklinghausen, Westphalia", "Berkheim, Kreis Biberach an der Riß" ] }, "default": [] }, "zipCode": { "title": "ZIP code", "type": "string", "description": "Optional. Required if you want to use the 'area' radius filter (wo= param)" }, "area": { "title": "Search radius (km)", "enum": [ "10", "15", "25", "50", "100", "200" ], "type": "string", "description": "Only applied if ZIP code is set (umkreis= param)", "default": "10" }, "publishedSince": { "title": "Published since", "enum": [ "0", "1", "2", "3", "4" ], "type": "string", "description": "How far back to search (veroeffentlichtseit= param)", "default": "4" }, "workingHours": { "title": "Working hours", "enum": [ "vz", "tz" ], "type": "string", "description": "Full time or part time (arbeitszeit= param)" }, "matchWords": { "title": "Match words", "type": "array", "description": "List of keywords to flag matching ads (checked against job title / profession / company description). Leave empty to skip matching.", "default": [], "items": { "type": "string" } }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Total number of job ads to fetch. Pages are fetched at 200 results/page, stopping early if the source runs out of results. Max 5000", "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 } } }, "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 } } } } } } } } } }