{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Job Scraper — Salary, Contact & Details", "description": "Scrape Germany's largest job board (arbeitsagentur.de). Extracts salary amount, employer email/phone, multi-location, home-office, occupation codes and full descriptions from the v6 API. Richer data than any competitor — no proxy or login needed.", "version": "0.1", "x-build-id": "7VZ8kmzbEqmcSk0ly" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/haketa~arbeitsagentur-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-haketa-arbeitsagentur-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/haketa~arbeitsagentur-scraper/runs": { "post": { "operationId": "runs-sync-haketa-arbeitsagentur-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/haketa~arbeitsagentur-scraper/run-sync": { "post": { "operationId": "run-sync-haketa-arbeitsagentur-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": { "keyword": { "title": "Keyword / job title", "type": "string", "description": "Search for a job title, skill or profession, e.g. 'Softwareentwickler', 'Pflegefachkraft', 'Marketing Manager'. Leave empty to get a mixed sample of popular jobs across Germany." }, "city": { "title": "City", "enum": [ "", "Berlin", "Hamburg", "München", "Köln", "Frankfurt am Main", "Stuttgart", "Düsseldorf", "Leipzig", "Dortmund", "Essen", "Bremen", "Dresden", "Hannover", "Nürnberg", "Duisburg", "Bochum", "Wuppertal", "Bielefeld", "Bonn", "Münster", "Karlsruhe", "Mannheim", "Augsburg", "Wiesbaden", "Mönchengladbach", "Gelsenkirchen", "Aachen", "Braunschweig", "Kiel", "Chemnitz", "Halle (Saale)", "Magdeburg", "Freiburg im Breisgau", "Krefeld", "Mainz", "Lübeck", "Erfurt", "Oberhausen", "Rostock", "Kassel" ], "type": "string", "description": "Pick a city to search in. Choose 'Whole of Germany' for a nationwide search. Need a town that isn't listed? Use the 'Custom location' box below instead.", "default": "" }, "location": { "title": "Custom location (advanced)", "type": "string", "description": "Optional: type any city, region or postal code (PLZ) not in the dropdown, e.g. 'Regensburg', '80331'. This overrides the City dropdown when set." }, "radius": { "title": "Radius (km)", "minimum": 0, "maximum": 200, "type": "integer", "description": "How far around the chosen location to search, in kilometres. 0 = that location only.", "default": 25 }, "employer": { "title": "Employer name", "type": "string", "description": "Optional: only return jobs from a specific employer, e.g. 'Siemens AG', 'Deutsche Bahn'. Leave empty for a general keyword/location search." }, "angebotsart": { "title": "Offer type", "enum": [ "", "1", "2", "4", "34" ], "type": "string", "description": "Which kind of opening to include.", "default": "" }, "arbeitszeit": { "title": "Working time", "enum": [ "", "vz", "tz", "ho", "mj", "snw" ], "type": "string", "description": "Filter by working-time model.", "default": "" }, "befristung": { "title": "Contract duration", "enum": [ "", "1", "2" ], "type": "string", "description": "Filter by contract type.", "default": "" }, "behinderung": { "title": "Disability-friendly only", "type": "boolean", "description": "Only return jobs suitable for people with disabilities.", "default": false }, "publishedSince": { "title": "Published since", "enum": [ "0", "1", "3", "7", "14", "30" ], "type": "string", "description": "Only include jobs published within this time window.", "default": "0" }, "includeDetails": { "title": "Include full job details", "type": "boolean", "description": "Fetch the full job description, all locations, contact info and employer profile for each listing. Enables email/phone extraction and requirements parsing. Slightly slower but far richer.", "default": true }, "maxItems": { "title": "Max jobs", "minimum": 0, "type": "integer", "description": "Maximum number of jobs to collect. Set 0 for no limit (can be very large for broad searches).", "default": 100 }, "maxPagesPerSearch": { "title": "Max pages per search", "minimum": 0, "type": "integer", "description": "Maximum result pages per search query (each page holds up to 100 jobs). 0 = no limit.", "default": 10 }, "startUrls": { "title": "Start URLs (advanced)", "type": "array", "description": "Optional for power users: paste arbeitsagentur.de search-result URLs (with your own filters) or individual job detail URLs. Used alongside the search above.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional. This scraper works without a proxy. You may enable a proxy if you run very large jobs and want to distribute traffic.", "default": { "useApifyProxy": false } }, "requestDelay": { "title": "Request delay (ms)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Delay between requests in milliseconds. Keep a small polite delay.", "default": 100 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 25, "type": "integer", "description": "Maximum parallel detail requests. Keep moderate.", "default": 10 } } }, "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 } } } } } } } } } }