{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Jobs Scraper: Bundesagentur für Arbeit API", "description": "Germany jobs scraper and MCP tool: German jobs from the official Arbeitsagentur Jobbörse API by keyword + place: title, company, address, occupation, full/part-time, remote, salary when given, dates, link. No login. Pay per job ($0.0009 or less) plus a $0.001 start fee per run.", "version": "0.1", "x-build-id": "RefOMD2aaUJWzgWUU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/plainrows~arbeitsagentur-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-plainrows-arbeitsagentur-jobs-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/plainrows~arbeitsagentur-jobs-scraper/runs": { "post": { "operationId": "runs-sync-plainrows-arbeitsagentur-jobs-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/plainrows~arbeitsagentur-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-plainrows-arbeitsagentur-jobs-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", "properties": { "keywords": { "title": "Keywords", "type": "array", "description": "Job titles, occupations or skills, in German or English (\"Data Engineer\", \"Pflegefachkraft\", \"Lagerhelfer\"). Each keyword is searched in each place below. Leave empty to list all jobs of the places.", "items": { "type": "string" } }, "locations": { "title": "Places (optional)", "type": "array", "description": "German towns, postal codes or regions (\"Berlin\", \"80331\", \"Hamburg\"), searched with the radius below. Leave empty to search all of Germany.", "items": { "type": "string" } }, "radiusKm": { "title": "Radius around each place (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Distance around each place, as on the Jobbörse (0 = the place only). Used only with places.", "default": 25 }, "offerType": { "title": "Offer type", "enum": [ "any", "job", "apprenticeship", "internship", "self-employment" ], "type": "string", "description": "Kind of offer, as the Jobbörse filter Angebotsart.", "default": "any" }, "workingTime": { "title": "Working time (optional)", "type": "array", "description": "Keep only jobs with one of these working times. Leave empty for all.", "items": { "type": "string", "enum": [ "fullTime", "partTime", "shiftNightWeekend", "homeOffice", "miniJob" ], "enumTitles": [ "Full-time", "Part-time", "Shift, night or weekend", "Home office / remote", "Mini job" ] } }, "publishedWithinDays": { "title": "Published in the last N days (optional)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only jobs published (or republished) in the last N days, 0 to 100. Leave empty for all. Use 1 for a daily feed of new jobs." }, "maxJobsPerSearch": { "title": "Max jobs per search", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The API returns 100 jobs per page and at most 10,000 jobs per search; the Actor reads the pages one after the other.", "default": 100 }, "searchUrls": { "title": "Jobbörse search URLs (optional)", "type": "array", "description": "Search pages copied from the Jobbörse, e.g. https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&was=Koch&wo=Hamburg&umkreis=25. Their filters (was, wo, umkreis, angebotsart, arbeitszeit, veroeffentlichtseit, befristung, zeitarbeit…) are kept; the filters above do not apply to them. Up to 100 searches per run.", "items": { "type": "string" } } } }, "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 } } } } } } } } } }