{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Scraper", "description": "Scrape job listings from Arbeitsagentur.de (Bundesagentur für Arbeit) — Germany's largest public employment database with 1.5M+ active postings. Extract titles, employers, locations, contracts, descriptions, and 30+ fields per listing.", "version": "1.1", "x-build-id": "ZxzdoiMzC6dadFuvl" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/parsebird~arbeitsagentur-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-parsebird-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/parsebird~arbeitsagentur-scraper/runs": { "post": { "operationId": "runs-sync-parsebird-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/parsebird~arbeitsagentur-scraper/run-sync": { "post": { "operationId": "run-sync-parsebird-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", "type": "string", "description": "Job title, skill, or profession to search for (e.g. \"Softwareentwickler\", \"Krankenpfleger\", \"Data Engineer\"). Leave empty when using direct search URLs." }, "location": { "title": "Location", "type": "string", "description": "City, postal code, or region to search around (e.g. \"Berlin\", \"10115\", \"Bayern\")." }, "employment_type": { "title": "Offer Type", "enum": [ "job", "education", "early_career", "self_employed" ], "type": "string", "description": "Category of job offer. Maps to the Bundesagentur \"Angebotsart\" parameter.", "default": "job" }, "radius": { "title": "Search Radius", "enum": [ "", "10_km", "15_km", "25_km", "50_km", "100_km", "200_km" ], "type": "string", "description": "Distance in kilometers around the location. Leave empty to search all of Germany.", "default": "" }, "is_remote": { "title": "Remote / Home Office Only", "type": "boolean", "description": "When enabled, only returns jobs marked as remote or home-office friendly.", "default": false }, "startUrls": { "title": "Direct Search URLs", "type": "array", "description": "Paste one or more Arbeitsagentur search-result URLs. Use this instead of the keyword/location fields when you want to reuse a search you configured on arbeitsagentur.de.", "default": [], "items": { "type": "string" } }, "publication_date": { "title": "Published Within", "enum": [ "", "today", "yesterday", "last_1_week", "last_2_weeks", "last_4_weeks" ], "type": "string", "description": "Only return listings published within this time window.", "default": "" }, "work_schedule": { "title": "Work Schedule", "type": "array", "description": "Filter by one or more work schedule types.", "items": { "type": "string", "enum": [ "full_time", "part_time", "shift_night_weekend", "part_time_job" ], "enumTitles": [ "Full-time (Vollzeit)", "Part-time (Teilzeit)", "Shift / night / weekend", "Mini-job (geringfügig)" ] }, "default": [] }, "fixed_term": { "title": "Contract Duration", "type": "array", "description": "Filter by contract type — temporary (befristet) or permanent (unbefristet).", "items": { "type": "string", "enum": [ "temporary", "indefinite" ], "enumTitles": [ "Temporary (befristet)", "Permanent (unbefristet)" ] }, "default": [] }, "beginning_date": { "title": "Preferred Start Period", "type": "array", "description": "One or more preferred start dates for the position.", "items": { "type": "string", "enum": [ "from_now_on", "may_2026", "june_2026", "july_2026", "august_2026", "september_2026", "october_2026", "november_2026", "december_2026", "january_2027", "february_2027", "march_2027", "april_2027", "may_2027", "june_2027", "july_2027", "august_2027", "september_2027", "october_2027", "february_2028", "april_2028" ], "enumTitles": [ "From now on", "May 2026", "June 2026", "July 2026", "August 2026", "September 2026", "October 2026", "November 2026", "December 2026", "January 2027", "February 2027", "March 2027", "April 2027", "May 2027", "June 2027", "July 2027", "August 2027", "September 2027", "October 2027", "February 2028", "April 2028" ] }, "default": [] }, "is_suitable_for_career_change": { "title": "Career Change Friendly", "type": "boolean", "description": "When enabled, focuses on roles marked as suitable for career changers (Quereinstieg).", "default": false }, "disabled_only_jobs": { "title": "Disability-Friendly Only", "type": "boolean", "description": "When enabled, only returns listings marked as suitable for applicants with disabilities.", "default": false }, "include_agency_jobs": { "title": "Include Recruitment Agency Listings", "type": "boolean", "description": "When enabled, includes listings from private recruitment agencies alongside direct employer postings.", "default": false }, "exclude_external_jobs": { "title": "Exclude External Job Board Listings", "type": "boolean", "description": "When enabled, removes listings that redirect to external job boards or third-party sites.", "default": false }, "exclude_temporary_work": { "title": "Exclude Temporary Work", "type": "boolean", "description": "When enabled, removes temporary-work and labor-leasing (Zeitarbeit) roles from results.", "default": false }, "limit": { "title": "Max Results", "minimum": 1, "type": "integer", "description": "Maximum number of job listings to collect. Start with a small number to validate output, then increase for larger runs.", "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 } } }, "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 } } } } } } } } } }