{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Jobs Scraper: Stellenangebote & Jobbörse", "description": "Jobs from the Jobbörse of the Bundesagentur für Arbeit: title, employer, place with coordinates, dates, full text, home office, working time, employer email and phone. Filter by radius, schedule, offer type. No API key. One price per job, details included. Stellenangebote als JSON, CSV oder Excel.", "version": "1.0", "x-build-id": "kXsyVVqgkSzT4Hw5c" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~arbeitsagentur-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-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/benthepythondev~arbeitsagentur-jobs-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-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/benthepythondev~arbeitsagentur-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-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": "Job keywords", "type": "array", "description": "German or English roles, skills, occupations or employer terms to search.", "default": [ "Softwareentwickler" ], "items": { "type": "string" } }, "locations": { "title": "German locations", "type": "array", "description": "Cities, regions or postcodes to search in Germany.", "default": [ "Berlin" ], "items": { "type": "string" } }, "radiusKm": { "title": "Search radius in kilometers", "minimum": 0, "maximum": 200, "type": "integer", "description": "Maximum distance around each requested location.", "default": 50 }, "offerType": { "title": "Offer type", "enum": [ "1", "2", "4", "34" ], "type": "string", "description": "Type of vacancy to request from the federal jobs API.", "default": "1" }, "workSchedules": { "title": "Work schedules", "type": "array", "description": "Optional working-time filters from the source API.", "items": { "type": "string", "enum": [ "vz", "tz", "snw", "ho", "mj" ], "enumTitles": [ "Full-time", "Part-time", "Shift/night/weekend", "Home office", "Mini-job" ] }, "default": [] }, "postedWithinDays": { "title": "Maximum posting age", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only request jobs published within this many days; use 0 for any age.", "default": 14 }, "includeTemporaryAgencies": { "title": "Include temporary-work agencies", "type": "boolean", "description": "Include vacancies posted by temporary-work agencies in source results.", "default": false }, "includeDetails": { "title": "Fetch full job details", "type": "boolean", "description": "Enrich each result with the full description, all locations, working time, remote status and public contacts.", "default": true }, "maxResultsPerSearch": { "title": "Maximum jobs per keyword and location", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum unique jobs saved for each keyword and location combination.", "default": 3 }, "maxPagesPerSearch": { "title": "Maximum API pages per search", "minimum": 1, "maximum": 100, "type": "integer", "description": "Safety cap for federal jobs API pagination.", "default": 3 } } }, "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 } } } } } } } } } }