{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Jobs Scraper - Germany Jobs from the Jobbörse", "description": "Jobs from Germany's federal job board (Bundesagentur für Arbeit) for any search and place, with full descriptions and, where given, salary ranges. Schedule it in new-only mode to get just the new jobs.", "version": "0.1", "x-build-id": "fS8bybWDZfCbgjcdP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/afterstar~arbeitsagentur-jobs/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-afterstar-arbeitsagentur-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/afterstar~arbeitsagentur-jobs/runs": { "post": { "operationId": "runs-sync-afterstar-arbeitsagentur-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/afterstar~arbeitsagentur-jobs/run-sync": { "post": { "operationId": "run-sync-afterstar-arbeitsagentur-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": { "query": { "title": "What (job title or keywords)", "type": "string", "description": "Like 'Softwareentwickler' or 'Pflegefachkraft'. Empty = all jobs." }, "location": { "title": "Where (city or postal code)", "type": "string", "description": "Like 'Berlin' or '80331'. Empty = all of Germany." }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Distance around the place, in kilometres.", "default": 25 }, "offerType": { "title": "Type", "enum": [ "jobs", "apprenticeship", "internship", "self-employment" ], "type": "string", "description": "The kind of offer.", "default": "jobs" }, "workingTime": { "title": "Working time", "type": "array", "description": "Leave empty for all.", "items": { "type": "string", "enum": [ "vz", "tz", "snw", "ho", "mj" ], "enumTitles": [ "Full-time", "Part-time", "Shifts / nights / weekends", "Home office", "Mini-job" ] } }, "employer": { "title": "Employer (exact name)", "type": "string", "description": "Only jobs from this employer, e.g. 'Deutsche Bahn AG'." }, "publishedWithinDays": { "title": "Published within (days)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Only jobs published in the last N days (0-100). Empty = all." }, "includeTempAgencies": { "title": "Include temp agencies (Zeitarbeit)", "type": "boolean", "description": "Jobs from temporary employment agencies.", "default": true }, "includePrivateAgencies": { "title": "Include private recruiters", "type": "boolean", "description": "Jobs posted by private employment agencies.", "default": true }, "fetchDetails": { "title": "Full descriptions and salary ranges", "type": "boolean", "description": "Fetches each job's detail page (description, salary range). In new-only mode only for new or changed jobs.", "default": true }, "maxItems": { "title": "Max jobs", "minimum": 1, "type": "integer", "description": "The most jobs per run.", "default": 100 }, "outputMode": { "title": "Output mode", "enum": [ "all", "new", "changes" ], "type": "string", "description": "'All' lists everything found now. 'Only new' lists results never seen in earlier runs. 'New, changed and removed' also lists results that changed or disappeared. The first scheduled run counts everything as new; use 'Baseline only' to start cheaply.", "default": "all" }, "baselineOnly": { "title": "Baseline only (remember the current results, output nothing)", "type": "boolean", "description": "Saves what exists now without listing it, so the next scheduled run shows only what's new. Charged like a run with nothing new.", "default": false }, "stateKey": { "title": "Memory name (optional)", "type": "string", "description": "Leave empty: each saved task keeps its own memory. Set a name to share one memory between tasks, or a new name to start over.", "default": "" }, "resetState": { "title": "Forget earlier runs", "type": "boolean", "description": "Starts from an empty memory: every result counts as new again.", "default": false }, "webhookUrl": { "title": "Webhook URL (optional)", "type": "string", "description": "We POST a summary plus up to 100 new, changed or removed results here when something changed. Works with Slack incoming webhooks (choose the Slack format), Zapier, Make and n8n.", "default": "" }, "webhookFormat": { "title": "Webhook format", "enum": [ "json", "slack" ], "type": "string", "description": "JSON for automation tools; 'Slack message' sends one line of text.", "default": "json" }, "webhookAlways": { "title": "Call the webhook on every run", "type": "boolean", "description": "By default the webhook is called only when something changed or a source failed.", "default": false }, "keepContactsInText": { "title": "Keep emails and phone numbers in texts", "type": "boolean", "description": "By default, emails and phone numbers inside free text (like job descriptions) are replaced by [redacted].", "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 }, "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 } } } } } } } } } }