# Bundesagentur für Arbeit (Arbeitsagentur) Scraper (`lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-scraper`) Actor The Arbeitsagentur Scraper is a web scraping tool that retrieves public job postings from Arbeitsagentur.de. Bundesagentur für Arbeit is the official job search website in Germany. - **URL**: https://apify.com/lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-scraper.md - **Developed by:** [Lexis Solutions](https://apify.com/lexis-solutions) (community) - **Categories:** Jobs, Lead generation - **Stats:** 629 total users, 58 monthly users, 99.9% runs succeeded, 38 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.99 / 1,000 listings 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/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. 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. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## 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. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ## Arbeitsagentur Scraper ![Arbeitsagentur Scraper](https://lexis-solutions-apify.fra1.cdn.digitaloceanspaces.com/banners/arbeitsagentur.png) ### 🔎 What is the Arbeitsagentur Scraper? The Arbeitsagentur Scraper is a web scraping tool that allows you to scrape Arbeitsagentur jobs. This actor uses the provided search query to fetch relevant job listings and extracts specific fields of interest. ### 🧾 What data can the Arbeitsagentur Scraper extract? The Arbeitsagentur Scraper can extract the following data from Arbeitsagentur search results: - Company Name - Contract Duration - Description Text - Job Type - Location - Main Job - Salary Note - Title - Employer Address ### 💼 What use cases does the Arbeitsagentur Scraper? The Arbeitsagentur Scraper is a web scraping tool used for collecting data from the online portal of the Bundesagentur für Arbeit (Federal Employment Agency) in German. It allows users to scrape jobs posted in the website according to predefined queries. Use Cases: - **Job Aggregation Services**: Websites like Indeed, Monster, and Glassdoor aggregate job listings from multiple job boards and company websites into a single platform. Scraping data from these sources helps keep job aggregator sites up-to-date with fresh job data. - **Market Research and Analysis**: Job data can be analyzed to identify job trends and understand the labor market. Researchers and analysts use this information to make informed decisions. - **Recruitment and Talent Acquisition**: Companies can track competitors’ open positions and compensation packages. This competitive intelligence gives them an edge in hiring quality candidates. - **Competitive Intelligence**: Scraping job postings allows you to monitor competitors’ hiring activities, providing insights into their strategies and talent needs. - **Salary Analysis and Benchmarking**: Collecting salary data from job postings helps companies benchmark their compensation packages against industry standards. - **Economic and Labor Market Research**: Researchers use job data to study economic trends, employment rates, and workforce dynamics. - **Career Counseling and Planning**: Job seekers can analyze job postings to plan their career paths and identify relevant opportunities. - **HR Technology and Software Development**: Job data fuels the development of HR software and tools, enhancing recruitment processes. ### 📖 How to use the Arbeitsagentur Scraper? 1. Create a free Apify account 2. Open Arbeitsagentur Scraper 3. Add either a position with or without a location or start url from a search on Arbeitsagentur 4. Click Start and wait for the results 5. Download the results in JSON, XML or CSV format or connect the actor to your backend via API Note: For best stability, set the actor Memory to at least 2 GB (2048 MB) in the Apify run settings. ### 📥 Input To run the actor, simply enter either a: - **Search URL** - the URL of the search you want to scrape (e.g. ) - **Position** - the name of the position you want to search for (e.g. Softwareentwickler) - **Location** (optional) - the name of a location here you want to look for the position (e.g. Berlin) - **Maximum number of items** - the maximum number of items to scrape. The actor will stop when it reaches this limit (e.g. 10) - **Proxy configuration** - choose between default proxy settings, Apify's RESIDENTIAL proxy or a custom proxy URL > **Note:** If `startUrls` are provided, they take precedence over `position` and `location`. The actor will only build a search URL from `position`/`location` when no `startUrls` are given. ### 📤 Output The results are stored in the default dataset associated with the actor. Each item is an ad, having the following format: | Field | Type | Description | Possible Values | | ------------------ | -------- | ----------------------------------- | ------------------------------------------------------------------------------------------- | | `contractDuration` | `string` | Duration of the employment contract | `KEINE_ANGABE` – Not specified
`UNBEFRISTET` – Permanent
`BEFRISTET` – Fixed-term | | `jobType` | `string` | Type of employment offer | `ARBEIT` – Regular employment | ```json { "allianzpartnerName": "Jobbörse-direkt.de - Maxime Media GmbH", "allianzpartnerUrl": "www.jobboerse-direkt.de", "url": "https://www.arbeitsagentur.de/jobsuche/jobdetail/12513-0007597600-S", "cipherNumber": null, "employerName": "A. u. K. Müller GmbH & Co. KG", "contractDuration": "UNBEFRISTET", "contractDurationMonths": null, "contractDurationLimitedTo": null, "descriptionText": "Teilen Sie unsere Faszination ... Jetzt bewerben", "employerCustomerNumberHash": null, "entryPeriod": "2025-07-01", "externalURL": "https://www.jobboerse-direkt.de/stellenangebote/Werkzeugmechaniker-m-w-d-im-Bereich-CAM-Programmierung-7597600", "isExternal": true, "isDisabilityRequired": false, "isFullTime": true, "isMarginalEmployment": false, "isPartTimeAfternoon": false, "isPartTimeEvening": false, "isPartTimeFlexible": false, "isPartTimeMorning": false, "isPrivateAgency": false, "isTemporaryEmployment": false, "isWorkFromHome": false, "jobType": "ARBEIT", "location": "40595, Düsseldorf, NORDRHEIN_WESTFALEN, DEUTSCHLAND", "mainJob": "Helfer/in - Feinmechanik, Werkzeugbau", "nightOrWeekendShift": false, "publishingStartDate": "2025-07-01", "referenceNumber": "12513-0007597600-S", "salaryNote": "KEINE_ANGABEN", "startDate": "2025-07-01", "title": "Werkzeugmechaniker (m/w/d) im Bereich CAM-Programmierung", "applicationEmail": null, "firstPublicationDate": "2025-07-01", "lastUpdatedAt": "2025-07-19T21:17:22.000", "employerAddress": "Berliner Platz 2, 53111 Bonn, DEUTSCHLAND", "employerWebsite": null, "employerIndustry": null, "employerFirmSize": null } ``` ### How many results can I scrape? The search an infinite scroll pagination system. This means that the actor will keep adding new jobs until it reaches the last results or it reaches the maximum number of results specified on the input. ### Why use the Arbeitsagentur Scraper? - ⚡️ **Fast** - The scraper is fast and efficient, allowing you to scrape items in a programmatic way. - 🤙 **Easy to use** - The scraper is easy to use and requires no coding knowledge. All you need to do is input the query you want to scrape and the scraper will do the rest. - ☑️ **Well-Maintained** - The scraper is maintained by the Lexis Solutions team, ensuring that it is always up-to-date and working properly. ### FAQ - **Is Scraping Arbeitsagentur Legal?** The current scraper only scrapes public data from Arbeitsagentur. This means that the data is publicly available and can be accessed by anyone. However, we recommend that you check Arbeitsagentur's Terms of Service before using the scraper. - **How much does it cost?** The cost for using the Arbeitsagentur Scraper is shown on the top of this page. You can also check the Apify Store page for more information. *** ### Need to scrape other job boards in Europe? - UK 🇬🇧 - [Reed.co.uk Scraper](https://apify.com/lexis-solutions/reed-co-uk-scraper) - [TotalJobs Scraper](https://apify.com/lexis-solutions/totaljobs-scraper) - France 🇫🇷 - [HelloWork Scraper](https://apify.com/lexis-solutions/hellowork-scraper) - Netherlands 🇳🇱 - [Werk.nl Scraper](https://apify.com/lexis-solutions/werk-nl-scraper) - Sweden 🇸🇪 - [Arbetsformedlingen Scraper](https://apify.com/lexis-solutions/arbetsformedlingen-se-scraper) 👀 p.s. Got feedback or need an extension? Lexis Solutions is a [certified Apify Partner](https://apify.com/partners/find). We can help you with custom solutions or data extraction projects. Contact us over [Email](mailto:scraping@lexis.solutions) or [LinkedIn](https://www.linkedin.com/company/lexis-solutions) ### Support Our Work 💝 If you're happy with our work and scrapers, you're welcome to leave us a company review [here](https://apify.com/partners/find/lexis-solutions/review) and leave a review for the scrapers you're subscribed to. It will take you less than a minute but it will mean a lot to us! # Actor input Schema ## `position` (type: `string`): Search parameter to use. ## `location` (type: `string`): Search in specific location ## `startUrls` (type: `array`): URLs to start with. ## `maxItems` (type: `integer`): Maximum number of items that will be extracted. ## `proxy` (type: `object`): Specify the proxy provider. You can use an Apify proxy, or provide a custom one. ## `debugMode` (type: `boolean`): Activate to see detailed logs ## Actor input object example ```json { "startUrls": [ { "url": "https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&was=Softwareentwickler%2Fin" } ], "maxItems": 10, "proxy": { "useApifyProxy": true }, "debugMode": false } ``` # 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 = { "startUrls": [ { "url": "https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&was=Softwareentwickler%2Fin" } ], "proxy": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-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 = { "startUrls": [{ "url": "https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&was=Softwareentwickler%2Fin" }], "proxy": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "startUrls": [ { "url": "https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&was=Softwareentwickler%2Fin" } ], "proxy": { "useApifyProxy": true } }' | apify call lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/jKhRaKtBpJsDYKyDe/builds/iFh5xWWp0cbS8z3jR/openapi.json