{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Jobs Scraper - German Job Listings API", "description": "Scrape job listings from the Bundesagentur für Arbeit Jobbörse (arbeitsagentur.de), Germany's largest job board: full descriptions, employer, location, salary when posted and external apply links. Filter by keyword, city, radius and date. New-jobs-only mode for alerts.", "version": "1.0", "x-build-id": "x6untTgXa5XgmDgaT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/kamerozkan~arbeitsagentur-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-kamerozkan-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/kamerozkan~arbeitsagentur-jobs-scraper/runs": { "post": { "operationId": "runs-sync-kamerozkan-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/kamerozkan~arbeitsagentur-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-kamerozkan-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": { "searchTerms": { "title": "Search terms", "type": "array", "description": "Job titles or keywords, as you would type them on arbeitsagentur.de, for example \"Data Analyst\" or \"Pflegefachkraft\". Each term is searched separately and duplicates are removed. Leave empty to get all jobs in the location.", "default": [ "Data Analyst" ], "items": { "type": "string" } }, "location": { "title": "Location", "type": "string", "description": "City, district or postal code in Germany, for example \"Berlin\", \"München\" or \"50667\". Leave empty to search all of Germany.", "default": "Berlin" }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Search radius around the location in kilometres. Used only when a location is set.", "default": 25 }, "publishedWithinDays": { "title": "Published within (days)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only jobs published in the last N days, for example 1 for a daily feed or 7 for a weekly one. Leave empty for all active jobs." }, "offerType": { "title": "Offer type", "enum": [ "job", "apprenticeship", "internship", "self-employment" ], "type": "string", "description": "Kind of listing: regular jobs, apprenticeships (Ausbildung and dual study), internships and trainee programmes, or self-employment offers.", "default": "job" }, "workTime": { "title": "Working time", "type": "array", "description": "Optional filter. Leave empty for all working times.", "items": { "type": "string", "enum": [ "vz", "tz", "snw", "mj" ], "enumTitles": [ "Full-time", "Part-time", "Shift, night and weekend", "Mini-job" ] } }, "employer": { "title": "Employer", "type": "string", "description": "Optional. Only jobs from this employer, written as on arbeitsagentur.de, for example \"Siemens AG\"." }, "includeDescription": { "title": "Include full job description", "type": "boolean", "description": "Fetch the full description text for every job. Turn off for faster runs when you only need titles, employers and locations. The price per job is the same.", "default": true }, "onlyNewJobs": { "title": "Only new jobs", "type": "boolean", "description": "Return only jobs that earlier runs with the same search did not return. Use with an Apify Schedule for job alerts: you pay only for new listings.", "default": false }, "historyKey": { "title": "History key", "type": "string", "description": "Optional name for the new-jobs-only history. Runs with the same key share one history. By default the key is derived from the search terms, location and filters." }, "maxItems": { "title": "Max jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many jobs. You are charged per job, so this also caps the cost of the run.", "default": 50 } } }, "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 } } } } } } } } } }