{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Jobs Monitor – New German Job Listings", "description": "Search the job board of the German Federal Employment Agency (Bundesagentur für Arbeit) by keyword, place, radius, offer type, working time and contract. One row per job: title, employer, location, salary, dates, links. Monitoring mode returns only new jobs.", "version": "0.1", "x-build-id": "MAhBgs8LC9cheajVY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~arbeitsagentur-jobs-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-arbeitsagentur-jobs-monitor", "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/neverempty~arbeitsagentur-jobs-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-arbeitsagentur-jobs-monitor", "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/neverempty~arbeitsagentur-jobs-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-arbeitsagentur-jobs-monitor", "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": { "what": { "title": "Job title or keyword (was)", "type": "string", "description": "What to search for, in German, as on the job board: a job title, an occupation or a keyword. Examples: Pflegefachkraft, Softwareentwickler, Lagerhelfer, Erzieher, Elektroniker. Leave empty to search every job in the chosen place." }, "where": { "title": "Place (wo)", "type": "string", "description": "A German city or a five-digit postal code. Examples: Berlin, München, Köln, 10115. Leave empty to search all of Germany. A place the job board does not know comes back as a no-such-location row and is not charged." }, "radiusKm": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "Distance around the place, in kilometres (0 to 200). Needs a place. Leave empty to use the default of the job board." }, "offerType": { "title": "Offer type", "enum": [ "job", "apprenticeship", "internship-trainee", "self-employment" ], "type": "string", "description": "Only offers of this type. Leave empty for all types." }, "workingTime": { "title": "Working time", "enum": [ "full-time", "part-time", "shift-night-weekend", "mini-job" ], "type": "string", "description": "Only jobs offered with this working time. Leave empty for all." }, "contract": { "title": "Contract", "enum": [ "permanent", "fixed-term" ], "type": "string", "description": "Only jobs with this kind of contract. Jobs that do not say are left out when this is set. Leave empty for all." }, "publishedWithinDays": { "title": "Published within the last N days", "minimum": 0, "maximum": 28, "type": "integer", "description": "Only jobs published in the last N days. The job board accepts 0 (today), 1, 7, 14 or 28 and silently ignores any other number, so only these five are allowed here. Leave empty for all listed jobs. Not used in monitoring mode, which works out the days from the previous run." }, "maxJobs": { "title": "Maximum jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many job rows (1 to 10000). The job board lets anyone page through the first 10,000 jobs of a search. Not used in monitoring mode: a monitoring run returns every new job.", "default": 100 }, "monitoringMode": { "title": "Monitoring mode (only new jobs)", "type": "boolean", "description": "Run the same search again and again (for example every hour on a schedule) and get only jobs that were not there before. The first run of a search only remembers the jobs published today and yesterday: it returns no job row and is free. Later runs return one row per new job. A run that finds no new job is charged one search-checked event instead.", "default": false }, "resetMonitoringState": { "title": "Reset monitoring memory for this search", "type": "boolean", "description": "Forget what was remembered for this search before the run. The run then behaves like a first monitoring run.", "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 } } } } } } } } } }