# Bundesagentur für Arbeit (Arbeitsagentur) Scraper (`lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-scraper`)

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://beta-securitybyobscurity.apify.com/lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-scraper.md
- **Developed by:** [Lexis Solutions](https://beta-securitybyobscurity.apify.com/lexis-solutions) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 186 total users, 35 monthly users, 99.8% runs succeeded, 24 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

$40.00/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/platform/actors/running/actors-in-store#rental-actors

# 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. <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** (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

### 📤 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 <br> `UNBEFRISTET` – Permanent <br> `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). We can help you with custom solutions or data extraction projects.

Contact us over [Email](mailto:info@lexis.solutions) or [LinkedIn](https://www.linkedin.com/company/lexis-solutions)

# 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
{
  "position": "Softwareentwickler/in",
  "startUrls": [
    {
      "url": "https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1&was=Softwareentwickler%2Fin"
    }
  ],
  "maxItems": 10,
  "proxy": {
    "useApifyProxy": true
  },
  "debugMode": false
}
```

# 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 = {
    "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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# 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("💾 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 '{
  "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": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=lexis-solutions/bundesagentur-fur-arbeit-arbeitsagentur-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Bundesagentur für Arbeit (Arbeitsagentur) Scraper",
        "description": "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.",
        "version": "1.0",
        "x-build-id": "JDBd4o9uYpLTRd2jp"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/lexis-solutions~bundesagentur-fur-arbeit-arbeitsagentur-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-lexis-solutions-bundesagentur-fur-arbeit-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/lexis-solutions~bundesagentur-fur-arbeit-arbeitsagentur-scraper/runs": {
            "post": {
                "operationId": "runs-sync-lexis-solutions-bundesagentur-fur-arbeit-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/lexis-solutions~bundesagentur-fur-arbeit-arbeitsagentur-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-lexis-solutions-bundesagentur-fur-arbeit-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",
                "required": [
                    "proxy"
                ],
                "properties": {
                    "position": {
                        "title": "Search for position",
                        "type": "string",
                        "description": "Search parameter to use.",
                        "default": "Softwareentwickler/in"
                    },
                    "location": {
                        "title": "Search location",
                        "type": "string",
                        "description": "Search in specific location"
                    },
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "URLs to start with.",
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    },
                    "maxItems": {
                        "title": "Maximum number of items",
                        "type": "integer",
                        "description": "Maximum number of items that will be extracted.",
                        "default": 10
                    },
                    "proxy": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Specify the proxy provider. You can use an Apify proxy, or provide a custom one.",
                        "default": {
                            "useApifyProxy": true
                        }
                    },
                    "debugMode": {
                        "title": "Debug Mode",
                        "type": "boolean",
                        "description": "Activate to see detailed logs",
                        "default": false
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
