{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Jobs Scraper: Bundesagentur Jobbörse", "description": "Scrape arbeitsagentur jobs from the Bundesagentur für Arbeit Jobbörse: search by keyword, place and radius, filter by job type and publication date, get one flat row per posting with employer, location, coordinates, dates and the full description. Monitor mode alerts on new postings.", "version": "0.1", "x-build-id": "eukmQAbnrq4awt9jb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/datahamster~bundesagentur-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-datahamster-bundesagentur-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/datahamster~bundesagentur-jobs/runs": { "post": { "operationId": "runs-sync-datahamster-bundesagentur-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/datahamster~bundesagentur-jobs/run-sync": { "post": { "operationId": "run-sync-datahamster-bundesagentur-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": { "maxItems": { "title": "Max items", "minimum": 1, "type": "integer", "description": "Stop after this many results (you are charged only for pushed items)", "default": 100 }, "mode": { "title": "Mode", "enum": [ "scrape", "monitor" ], "type": "string", "description": "scrape = full results; monitor = only new/changed items since the previous run of this task", "default": "scrape" }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Optional state key when not running as a saved task" }, "webhookUrl": { "title": "Webhook URL", "type": "string", "description": "POST a change summary here in monitor mode" }, "telegramBotToken": { "title": "Telegram bot token", "type": "string", "description": "Optional: bot token for monitor-mode change summaries" }, "telegramChatId": { "title": "Telegram chat id", "type": "string", "description": "Optional: chat id that receives monitor-mode summaries" }, "searches": { "title": "Searches", "type": "array", "description": "List of searches as JSON objects: {\"was\": \"python\", \"wo\": \"Berlin\"}. `was` is the search term (job title, skill, employer) typed into the Jobbörse; `wo` is a city, postcode or region and drives the radius search — leave it out to search all of Germany. A plain string is taken as `was`, e.g. \"pflege\". Example: [{\"was\": \"python\", \"wo\": \"Berlin\"}, {\"was\": \"pflege\", \"wo\": \"Hamburg\"}].", "default": [ { "was": "python", "wo": "Berlin" } ] }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius in km around the place given in `wo`, e.g. 25. Ignored for searches without a place. Range 0-200.", "default": 25 }, "jobType": { "title": "Job type", "enum": [ "any", "ARBEIT", "AUSBILDUNG", "PRAKTIKUM", "SELBSTAENDIGKEIT" ], "type": "string", "description": "Restrict the search to one offer type of the Jobbörse, e.g. AUSBILDUNG for apprenticeships and dual study places. Default: any.", "default": "any" }, "publishedSinceDays": { "title": "Published in the last N days", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only postings published within this many days, e.g. 7 for the last week. Leave empty for all postings." }, "maxPagesPerSearch": { "title": "Pages per search", "minimum": 1, "maximum": 40, "type": "integer", "description": "How many result pages to read per search; one page holds 25 postings, so 3 pages = up to 75 rows per search. Range 1-40.", "default": 3 }, "fetchDetails": { "title": "Open each posting", "type": "boolean", "description": "true = open every posting to add the full description text and the employer's business facts (size, headquarters, website, benefits) — one extra request per posting. false = the search row only, which already carries employer, location, coordinates and dates. Example: false.", "default": false } } }, "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 } } } } } } } } } }