# Bundesagentur für Arbeit (Arbeitsagentur) Scraper Cheapest (`madeingermany/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.

This is the cheapest and most unlimited scraper for this.

- **URL**: https://apify.com/madeingermany/arbeitsagentur-scraper.md
- **Developed by:** [Made In Germany](https://apify.com/madeingermany) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 9 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$9.99/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period. You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#rental-actors

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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 Scraper

### 🔎 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. It interacts cleanly with the underlying APIs for top speeds and comprehensive data extraction.

### 🧾 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. Scraping helps keep sites up-to-date.
- **Market Research and Analysis:** Job data can be analyzed to identify job trends and understand the labor market.
- **Recruitment and Talent Acquisition:** Companies can track competitors’ open positions and compensation packages.
- **Competitive Intelligence:** Monitor competitors’ hiring activities, providing insights into their strategies.
- ... and much more!

### 📖 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 a 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. `https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&was=Softwareentwickler%2Fin&wo=Berlin&umkreis=25`)
- **Position** - the name of the position you want to search for (e.g. `Softwareentwickler`)
- **Location** - 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.
- **Proxy configuration** - choose between default proxy settings, Apify's RESIDENTIAL proxy or a custom proxy URL.

### 📤 Output

The results are stored in the default dataset associated with the actor. Each item is an ad, having the formatted format matching the exact original website values, ensuring no data loss.

# Actor input Schema

## `searchUrl` (type: `string`):

The URL of the search you want to scrape (e.g. https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1)

## `position` (type: `string`):

The name of the position you want to search for (e.g. Softwareentwickler)

## `location` (type: `string`):

The name of a location where you want to look for the position (e.g. Berlin)

## `maxItems` (type: `integer`):

The maximum number of items to scrape.

## `proxyConfiguration` (type: `object`):

Choose between default proxy settings, Apify's RESIDENTIAL proxy or a custom proxy URL

## Actor input object example

```json
{
  "maxItems": 100,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("madeingermany/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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("madeingermany/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 '{}' |
apify call madeingermany/arbeitsagentur-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,madeingermany/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 <APIFY_API_TOKEN>` 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/TUGwqYhIeqWhn1aOQ/builds/X12Z2evycFMxiLi99/openapi.json