{ "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Scraper | $1 / 1k | Bundesagentur für Arbeit", "description": "Scrape jobs from Germany’s Bundesagentur für Arbeit. Paste official search URLs and get full, clean, structured data including title, company, locations, contract/work type, dates, salary and more. Ideal for field research and job search.", "version": "0.0", "x-build-id": "OhczSPtXrINl2yxt6" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/fatihtahta~arbeitsagentur-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-fatihtahta-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/fatihtahta~arbeitsagentur-scraper/runs": { "post": { "operationId": "runs-sync-fatihtahta-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/fatihtahta~arbeitsagentur-scraper/run-sync": { "post": { "operationId": "run-sync-fatihtahta-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": { "employment_type": { "title": "Choose an Employment Type", "enum": [ "job", "education", "early_career", "self_employed" ], "type": "string", "description": "Select which type of opportunity to search for when using the built-in query builder." }, "keyword": { "title": "Enter Keywords to Match Relevant Jobs", "type": "string", "description": "Add job titles, skills, technologies, or other search terms to focus the results on the kinds of positions you want. Leave this empty if you want to rely on the terms already included in your direct search URL." }, "location": { "title": "Choose a Location to Search Around", "type": "string", "description": "Enter a city, district, postal code, or region to target jobs in a specific area. If you also provide direct search URLs, this value takes priority over the location already included in those links." }, "radius": { "title": "Set the Search Radius", "enum": [ "10_km", "15_km", "25_km", "50_km", "100_km", "200_km" ], "type": "string", "description": "Select how wide the location-based search should be. Smaller radiuses keep results local, while larger ones include jobs from a broader surrounding area." }, "is_remote": { "title": "Show Remote-Friendly Jobs Only", "type": "boolean", "description": "Enable this if you want to limit results to listings marked as remote or home-office friendly." }, "is_suitable_for_career_change": { "title": "Focus on Career-Change-Friendly Roles", "type": "boolean", "description": "Enable this to prioritize listings that are suitable for applicants changing careers or starting a new professional path." }, "beginning_date": { "title": "Choose a Preferred Start Date", "uniqueItems": true, "type": "array", "description": "Select one or more start periods if you want to focus on jobs beginning immediately or within specific upcoming months.", "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" ] } }, "fixed_term": { "title": "Choose Contract Duration Types", "uniqueItems": true, "type": "array", "description": "Select the contract types you want to include so the results better match your preferred employment terms.", "items": { "type": "string", "enum": [ "temporary", "indefinite" ], "enumTitles": [ "temporary", "indefinite" ] } }, "include_agency_jobs": { "title": "Include Jobs Posted by Recruitment Agencies", "type": "boolean", "description": "Includes additional job postings provided by private recruitment agencies. Enable this to expand results with third-party personnel placement listings, or leave it disabled to keep results focused on direct employer postings." }, "exclude_external_jobs": { "title": "Remove Listings from External Job Boards", "type": "boolean", "description": "Removes listings that point to external job boards or third-party sources. Enable this to keep results closer to native Arbeitsagentur postings." }, "exclude_temporary_work": { "title": "Hide Temporary Work Listings", "type": "boolean", "description": "Removes temporary-work and labor-leasing positions from the results. Enable this to focus on standard non-temporary employment listings." }, "disabled_only_jobs": { "title": "Show Jobs Marked for Disabled Applicants", "type": "boolean", "description": "Enable this to limit the results to positions explicitly marked as suitable for disabled applicants." }, "publication_date": { "title": "Choose How Recent the Listings Should Be", "enum": [ "today", "yesterday", "last_1_week", "last_2_weeks", "last_4_weeks" ], "type": "string", "description": "Use this to focus on fresh postings, such as jobs published today, yesterday, or within the last few weeks." }, "work_schedule": { "title": "Choose Preferred Work Schedules", "uniqueItems": true, "type": "array", "description": "Select one or more schedule types, such as full-time, part-time, or shift-based work, to better match your search goals.", "items": { "type": "string", "enum": [ "full_time", "part_time", "shift_night_weekend", "part_time_job" ], "enumTitles": [ "Full-time", "Part-time", "Shift/Night/Weekend", "Part-time job" ] } }, "startUrls": { "title": "Provide Direct Search Result URLs", "type": "array", "description": "Paste search-result URLs from the Bundesagentur site to scrape those result pages directly. This is useful when you have already configured the search on the site and want to reuse it here.", "items": { "type": "string" } }, "limit": { "title": "Set the Maximum Number of Jobs to Collect", "type": "integer", "description": "Choose the largest number of job listings the actor should save before stopping. Lower limits are useful for testing, while higher limits help with full-scale collection.", "default": 50000 } } }, "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 } } } } } } } } } }