# Arbeitsagentur Jobs Scraper (`automation-lab/arbeitsagentur-jobs-scraper`) Actor 🇩🇪 Extract official German job listings from Bundesagentur für Arbeit with employers, locations, dates, descriptions, and apply URLs. - **URL**: https://apify.com/automation-lab/arbeitsagentur-jobs-scraper.md - **Developed by:** [Stas Persiianenko](https://apify.com/automation-lab) (community) - **Categories:** Jobs - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per event This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Arbeitsagentur Jobs Scraper Extract job listings from the official Bundesagentur für Arbeit Jobsuche. ### What does Arbeitsagentur Jobs Scraper do? Arbeitsagentur Jobs Scraper collects structured job listing data from `arbeitsagentur.de`, the public job-search portal of Germany's Federal Employment Agency. It accepts a keyword and location, or direct Jobsuche result URLs, then exports listings to an Apify dataset. The actor can also open job detail pages to capture full descriptions, external application links, remote-work flags, start dates, and publication dates. Use it when you need repeatable exports of official German employment listings without manually copying data from the Jobsuche UI. ### Who is it for? Recruiters use it to monitor hiring demand in a city or profession. Job aggregators use it to enrich boards with official public-employment listings. ATS vendors use it to test matching and enrichment pipelines against German listings. Labor-market analysts use it to track occupations, regions, employers, remote-work signals, and posting dates. Sales teams use it to discover employers actively hiring in Germany. ### Why use this actor? ✅ Official public source for German employment listings. ✅ HTTP-first extraction without browser overhead. ✅ Detail-page mode for full job descriptions. ✅ Direct URL mode for reproducible searches. ✅ Clean output fields for BI, CRM, ATS, and data warehouse workflows. ### Data you can extract | Field | Description | | --- | --- | | `title` | Job title from Arbeitsagentur | | `employer` | Employer or advertiser name | | `referenceNumber` | Arbeitsagentur reference number | | `jobUrl` | Canonical detail page URL | | `externalApplyUrl` | External apply URL when listed | | `occupation` | Main occupation/profession | | `locations` | Structured locations and coordinates | | `city` | First city convenience field | | `region` | First region convenience field | | `remotePossible` | Home-office flag | | `salaryInfo` | Salary descriptor when present | | `startDate` | Planned job start date | | `publicationDate` | Publication date | | `updatedAt` | Last update timestamp | | `description` | Full job description when detail mode is enabled | ### How much does it cost to scrape Arbeitsagentur jobs? This actor uses pay-per-event pricing. You pay a small start fee and then a per-result fee for each saved job listing. Small test runs with the default prefill are intentionally cheap. For large recurring monitoring jobs, set `maxItems` to the number of listings you need and schedule the actor from Apify. ### How to scrape Arbeitsagentur jobs 1. Open the actor on Apify. 2. Enter a keyword such as `developer`, `pflegefachkraft`, or `ausbildung`. 3. Enter a German city, postal code, or place name. 4. Choose a maximum number of jobs. 5. Keep detail pages enabled if you need descriptions. 6. Start the run. 7. Download the dataset as JSON, CSV, Excel, or via API. ### Input options #### Keyword / job title Use the same search words you would type into Jobsuche. Examples: - `developer` - `pflegefachkraft` - `lagerist` - `ausbildung kaufmann` #### Location Use a city or place name accepted by Arbeitsagentur Jobsuche. Examples: - `Berlin` - `München` - `Hamburg` - `Frankfurt am Main` #### Radius Set a radius in kilometers if you want jobs around the location. Leave it empty to use the website default. #### Direct search URLs Paste one or more URLs from `https://www.arbeitsagentur.de/jobsuche/suche?...`. When direct URLs are provided, the actor uses them instead of keyword and location fields. #### Maximum jobs Use `maxItems` to control the dataset size and spend. #### Detail pages Enable `includeDetails` to fetch each detail page and capture the full description. Disable it for faster search-only exports. ### Example input ```json { "keyword": "developer", "location": "Berlin", "radiusKm": 25, "maxItems": 25, "maxPages": 2, "includeDetails": true } ```` ### Example output ```json { "title": "Java Developer (w/m/d)", "employer": "pulsation-it", "referenceNumber": "13644-208756-S", "jobUrl": "https://www.arbeitsagentur.de/jobsuche/jobdetail/13644-208756-S", "externalApplyUrl": "https://www.get-in-it.de/jobsuche/p208756", "occupation": "Anwendungsprogrammierer/in", "city": "Berlin", "remotePossible": true, "publicationDate": "2026-04-15" } ``` ### Tips for better results Use German job titles for German-language roles. Use broader terms first, then narrow by location or radius. Use direct URLs when you want to reproduce a search from the browser. Keep `maxPages` aligned with `maxItems`; the website returns about 25 listings per page. Disable detail pages if you only need employer, title, location, and apply URL. ### Integrations #### Recruiting dashboards Send the dataset to Google Sheets, BigQuery, Snowflake, or a BI dashboard. #### ATS enrichment Match `referenceNumber`, employer, title, and description against internal jobs. #### Market monitoring Schedule searches for occupations and cities to track posting volume over time. #### Lead generation Export employers that are actively hiring in specific German regions. ### API usage #### Node.js ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: process.env.APIFY_TOKEN }); const run = await client.actor('automation-lab/arbeitsagentur-jobs-scraper').call({ keyword: 'developer', location: 'Berlin', maxItems: 25 }); console.log(run.defaultDatasetId); ``` #### Python ```python from apify_client import ApifyClient import os client = ApifyClient(os.environ['APIFY_TOKEN']) run = client.actor('automation-lab/arbeitsagentur-jobs-scraper').call(run_input={ 'keyword': 'pflegefachkraft', 'location': 'München', 'maxItems': 25, }) print(run['defaultDatasetId']) ``` #### cURL ```bash curl -X POST "https://api.apify.com/v2/acts/automation-lab~arbeitsagentur-jobs-scraper/runs?token=$APIFY_TOKEN" \ -H 'Content-Type: application/json' \ -d '{"keyword":"developer","location":"Berlin","maxItems":25}' ``` ### MCP usage Use this actor from Claude through the Apify MCP server. MCP URL: `https://mcp.apify.com/?tools=automation-lab/arbeitsagentur-jobs-scraper` Claude Code setup: ```bash claude mcp add apify-arbeitsagentur-jobs https://mcp.apify.com/?tools=automation-lab/arbeitsagentur-jobs-scraper ``` Claude Desktop JSON config: ```json { "mcpServers": { "apify-arbeitsagentur-jobs": { "url": "https://mcp.apify.com/?tools=automation-lab/arbeitsagentur-jobs-scraper" } } } ``` Example prompts: - "Scrape 50 developer jobs in Berlin from Arbeitsagentur and summarize the top employers." - "Find Pflegefachkraft listings near München and export title, employer, city, and apply URL." - "Monitor official German public employment listings for warehouse jobs in Hamburg." ### Scheduling Create an Apify task with your keyword, location, and limits. Run it daily or weekly to build a time series of German labor-market demand. Use the `scrapedAt` field to compare snapshots. ### Data quality notes Arbeitsagentur data is user-facing public data from the Jobsuche pages. Some fields depend on what the employer supplied. Salary details are often descriptor values rather than numeric salary ranges. External apply URLs may point to partner job boards or employer systems. ### Limitations This actor does not log in. It does not apply to jobs. It does not bypass private employer systems. It extracts what the public Jobsuche pages render for anonymous visitors. ### Legality This actor extracts publicly available job listing pages. You are responsible for using the data lawfully and respecting applicable terms, privacy, copyright, and database-right rules. Avoid collecting personal data unless you have a lawful basis. ### FAQ #### Is it legal to scrape Arbeitsagentur jobs? The actor is designed for public job listing pages. Your use case, storage, and redistribution obligations remain your responsibility. #### Can I use this for recurring monitoring? Yes. Create an Apify task with a fixed keyword, location, and maximum item count, then schedule it daily or weekly. ### Troubleshooting #### I got zero results Check the same keyword and location in the Arbeitsagentur web UI. Try a broader keyword, remove the radius, or use a direct search URL. #### Descriptions are empty Enable `includeDetails`. Search-only mode exports listing-card fields but skips detail pages. #### My run is slow Detail pages add one request per listing. Disable details or lower `maxItems` for faster runs. ### Related scrapers - https://apify.com/automation-lab/greenhouse-jobs-scraper - https://apify.com/automation-lab/freelancer-jobs-scraper - https://apify.com/automation-lab/omni-jobs-board-scraper ### Use cases #### German recruiting intelligence Track which companies are hiring for specific roles in German cities. #### Public job-board aggregation Export listings from an official public employment board into your own index. #### Labor-market analytics Measure posting volume by occupation, city, region, and date. #### Sales prospecting Find employers with current hiring needs and route them to a CRM. ### Changelog Initial version extracts search results, detail descriptions, locations, dates, employer names, apply URLs, and source metadata. ### Support If a run fails or an important field is missing, open an issue with the input you used and a link to the run. # Actor input Schema ## `keyword` (type: `string`): German or English keyword to search for, e.g. developer, Pflegefachkraft, Lagerist, Ausbildung. ## `location` (type: `string`): City, postal code, or place name used by Arbeitsagentur Jobsuche. ## `radiusKm` (type: `integer`): Optional radius around the location. Leave empty for the website default. ## `searchUrls` (type: `array`): Optional direct Jobsuche search URLs. If supplied, these are used instead of keyword/location fields. ## `maxItems` (type: `integer`): Maximum number of job listings to save. ## `maxPages` (type: `integer`): Safety limit for paginated search result pages. Arbeitsagentur currently returns up to 25 jobs per page. ## `includeDetails` (type: `boolean`): Fetch each detail page to include the full job description and extra flags. Disable for faster search-only exports. ## Actor input object example ```json { "keyword": "developer", "location": "Berlin", "radiusKm": 10, "searchUrls": [ { "url": "https://www.arbeitsagentur.de/jobsuche/suche?was=developer&wo=Berlin" } ], "maxItems": 10, "maxPages": 2, "includeDetails": true } ``` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "keyword": "developer", "location": "Berlin", "radiusKm": 10, "searchUrls": [ { "url": "https://www.arbeitsagentur.de/jobsuche/suche?was=developer&wo=Berlin" } ], "maxItems": 10, "maxPages": 2, "includeDetails": true }; // Run the Actor and wait for it to finish const run = await client.actor("automation-lab/arbeitsagentur-jobs-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "keyword": "developer", "location": "Berlin", "radiusKm": 10, "searchUrls": [{ "url": "https://www.arbeitsagentur.de/jobsuche/suche?was=developer&wo=Berlin" }], "maxItems": 10, "maxPages": 2, "includeDetails": True, } # Run the Actor and wait for it to finish run = client.actor("automation-lab/arbeitsagentur-jobs-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "keyword": "developer", "location": "Berlin", "radiusKm": 10, "searchUrls": [ { "url": "https://www.arbeitsagentur.de/jobsuche/suche?was=developer&wo=Berlin" } ], "maxItems": 10, "maxPages": 2, "includeDetails": true }' | apify call automation-lab/arbeitsagentur-jobs-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=automation-lab/arbeitsagentur-jobs-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Arbeitsagentur Jobs Scraper", "description": "🇩🇪 Extract official German job listings from Bundesagentur für Arbeit with employers, locations, dates, descriptions, and apply URLs.", "version": "0.1", "x-build-id": "bcd3Fuhm45gOGBrFi" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/automation-lab~arbeitsagentur-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-automation-lab-arbeitsagentur-jobs-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/automation-lab~arbeitsagentur-jobs-scraper/runs": { "post": { "operationId": "runs-sync-automation-lab-arbeitsagentur-jobs-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/automation-lab~arbeitsagentur-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-automation-lab-arbeitsagentur-jobs-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": "German or English keyword to search for, e.g. developer, Pflegefachkraft, Lagerist, Ausbildung." }, "location": { "title": "Location", "type": "string", "description": "City, postal code, or place name used by Arbeitsagentur Jobsuche." }, "radiusKm": { "title": "Radius in km", "minimum": 1, "maximum": 200, "type": "integer", "description": "Optional radius around the location. Leave empty for the website default." }, "searchUrls": { "title": "Arbeitsagentur search URLs", "type": "array", "description": "Optional direct Jobsuche search URLs. If supplied, these are used instead of keyword/location fields.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxItems": { "title": "Maximum jobs", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum number of job listings to save.", "default": 50 }, "maxPages": { "title": "Maximum search pages", "minimum": 1, "maximum": 400, "type": "integer", "description": "Safety limit for paginated search result pages. Arbeitsagentur currently returns up to 25 jobs per page.", "default": 5 }, "includeDetails": { "title": "Open job detail pages", "type": "boolean", "description": "Fetch each detail page to include the full job description and extra flags. Disable for faster search-only exports.", "default": true } } }, "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 } } } } } } } } } } ```