{
"openapi": "3.0.1",
"info": {
"title": "Arbeitsagentur Scraper · German Federal Job Board Listings",
"description": "Arbeitsagentur jobs scraper for Germany's federal employment agency (arbeitsagentur.de / Bundesagentur für Arbeit). Scrape German job listings with employer, salary, location, and contact details.",
"version": "1.0",
"x-build-id": "GeVZOfI6XKfVNBbcP"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/reapx~arbeitsagentur-scraper/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-reapx-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/reapx~arbeitsagentur-scraper/runs": {
"post": {
"operationId": "runs-sync-reapx-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/reapx~arbeitsagentur-scraper/run-sync": {
"post": {
"operationId": "run-sync-reapx-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": {
"what": {
"title": "Job title or keyword",
"type": "string",
"description": "What to search for, in German. For example Pflege, Softwareentwickler, Verkäufer, LKW-Fahrer. Leave empty to search every occupation."
},
"where": {
"title": "City or postal code",
"type": "string",
"description": "Where to search, for example Berlin, München, or 10115. Combine with a radius to cover the surrounding area.
Leave this field empty to skip this filter."
},
"radiusKm": {
"title": "Search radius in kilometres",
"minimum": 0,
"maximum": 200,
"type": "integer",
"description": "How far around the city or postal code to search. Only applies when a location is set."
},
"workingTime": {
"title": "Working time",
"enum": [
"",
"vollzeit",
"teilzeit",
"schicht",
"homeoffice",
"minijob"
],
"type": "string",
"description": "Restrict to one working-time model.
Options: vollzeit, teilzeit, schicht, homeoffice, minijob."
},
"contractType": {
"title": "Contract type",
"enum": [
"",
"permanent",
"fixed-term"
],
"type": "string",
"description": "Permanent (unbefristet) or fixed-term (befristet).
Options: permanent, fixed-term."
},
"employer": {
"title": "Employer name",
"type": "string",
"description": "Restrict to one employer, for example SAP, Siemens, or Charité.
Leave this field empty to skip this filter."
},
"publishedWithinDays": {
"title": "Published within the last N days",
"minimum": 0,
"maximum": 100,
"type": "integer",
"description": "Only postings published this recently. Use 1 for a daily monitor, 7 for a weekly one.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned."
},
"excludeTempAgencies": {
"title": "Exclude temp agencies",
"type": "boolean",
"description": "Drop postings from Zeitarbeit staffing agencies and keep only direct employers."
},
"maxJobs": {
"title": "Maximum jobs to return",
"minimum": 1,
"maximum": 10000,
"type": "integer",
"description": "Hard ceiling on the rows this run produces, and therefore on what it costs. You are charged per job returned.
The higher the number, the longer the run takes and the more you are charged, because you pay per row returned."
},
"requestsPerSecond": {
"title": "Requests per second",
"minimum": 1,
"maximum": 8,
"type": "integer",
"description": "Politeness against the federal API. Lower this if you see the source refusing requests."
}
}
},
"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
}
}
}
}
}
}
}
}
}
}