# Arbeitsagentur Jobs Scraper: 1M German Jobs with Salaries (`gleanery_actors/arbeitsagentur-jobs-scraper`) Actor

\[💰 $2 / 1K] Search Germany's largest job board (Bundesagentur für Arbeit Jobsuche, 1M+ jobs) by job title, city, radius and date. Salaries, company website, address, remote, contract type. Exclude temp agencies. $2 per 1,000 jobs.

- **URL**: https://apify.com/gleanery_actors/arbeitsagentur-jobs-scraper.md
- **Developed by:** [Martin Farias](https://apify.com/gleanery_actors) (community)
- **Categories:** Jobs, Lead generation, AI
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 job results

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 Jobs Scraper: 1M German Jobs with Salaries

**Arbeitsagentur Jobs Scraper** searches the **Jobsuche of the Bundesagentur für Arbeit** (German Federal Employment Agency), Germany's largest job board with **over 1 million open jobs**, and returns clean, English-keyed JSON: job title, employer, workplace address and coordinates, **salary**, remote/home office, contract type, working time, start date and the full description. Search by job title, city or postal code, radius and date. **Drop temp agencies (Zeitarbeit) and private recruiters** with one switch.

Built for **job boards and aggregators**, **recruiting and HR tech**, **labor market research**, **sales teams looking for companies that are hiring**, and **AI agents** answering job questions about Germany.

👉 **Try it now:** keep the prefilled input (Softwareentwickler in Berlin, 20 jobs) and click **Start**. That's 4 cents.

### 🤖 Quick reference for AI agents

- **Actor ID:** `gleanery_actors/arbeitsagentur-jobs-scraper`. MCP: `https://mcp.apify.com?tools=gleanery_actors/arbeitsagentur-jobs-scraper`
- **Use it when** the user asks for jobs in Germany (any sector: IT, nursing, trades, logistics, retail, apprenticeships), salaries for a German job, or which German companies are hiring for a role.
- **Minimal input:** `{"searchTerms": ["Pflegefachkraft"], "location": "Hamburg", "maxItems": 30}`. German job titles match best.
- **Useful inputs:** `postedWithinDays`, `radiusKm`, `remoteOnly`, `onlyWithSalary`, `minSalaryYearly`, `excludeTempAgencies`, `excludePrivateRecruiters`, `offerType` (`job`, `apprenticeship`, `internship`), `workingTime` (`fullTime`, `partTime`)
- **Output:** one item per job: `title`, `companyName`, `city`, `postalCode`, `region`, `remote`, `contractType`, `salaryMin`, `salaryMax`, `salaryInterval`, `postedAt`, `url`, `externalUrl`, `description`
- **Save context tokens:** `"includeDescription": false` (also much faster), or `"descriptionMaxLength": 300`, plus `"omitEmptyFields": true`
- **Cost:** $0.002 per job. No start fee.
- **No Apify account?** Agents can pay per use with x402 or MPP through [agi.apify.com](https://agi.apify.com).

### ✨ Why this Arbeitsagentur scraper

- 🇩🇪 **The whole German job market**: 1M+ jobs, from software developers and engineers to nurses, electricians, drivers and apprenticeships. Many are posted nowhere else.
- 💶 **Salaries as numbers**: `salaryMin`, `salaryMax` and `salaryInterval` (year, month, hour), parsed from salary ranges and fixed pay. Filter with `onlyWithSalary` or `minSalaryYearly`.
- 🧹 **Direct employers only, if you want**: `excludeTempAgencies` drops Zeitarbeit offers (up to 40% of some searches), `excludePrivateRecruiters` drops placement agencies, and every job has `isTempAgency` / `isPrivateRecruiter` flags.
- 📍 **Precise location**: street, postal code, city, state (Bundesland) and latitude/longitude for maps and distance filters.
- 🏢 **Company website** when the employer posted directly, and `postedVia` when a partner board delivered the job.
- 🔁 **Monitoring mode**: schedule it daily and get (and pay for) only **new or edited** jobs.
- 🌐 **English field names**, so it plugs into your pipeline next to other job sources.
- 💵 **$2 per 1,000 jobs**, cheaper on paid Apify plans. No start fee, no proxy costs.

### 📋 Data you get

| Field | Example |
|---|---|
| `title` | Softwareentwickler Backend (m/w/d) |
| `occupation`, `occupations` | Softwareentwickler/in |
| `companyName` | TÜV SÜD Business Service GmbH |
| `companyWebsite`, `postedVia` | https://www.example.de, jobvector.de |
| `street`, `postalCode`, `city`, `region`, `country` | Westendstraße, 80686, München, Bayern, Deutschland |
| `latitude`, `longitude`, `distanceKm` | 48.13, 11.52, 4 |
| `remote` | true |
| `offerType` | job / apprenticeship / internship / selfEmployment |
| `fullTime`, `partTime`, `shiftNightWeekend`, `miniJob` | true, false, false, false |
| `contractType` | permanent / fixedTerm |
| `startDate` | 2026-11-01 |
| `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryInterval` | 60000, 75000, EUR, year |
| `isTempAgency`, `isPrivateRecruiter` | false, false |
| `suitableForCareerChangers` | true (Quereinstieg) |
| `postedAt`, `updatedAt` | 2026-10-20 |
| `url` | arbeitsagentur.de job page |
| `externalUrl` | original posting, when hosted elsewhere |
| `description` | full job text |

### 🧾 Input examples

**Backend developers in Munich, direct employers, with salary, posted this week:**

```json
{
  "searchTerms": ["Backend Entwickler", "Softwareentwickler"],
  "location": "München",
  "radiusKm": 30,
  "postedWithinDays": 7,
  "excludeTempAgencies": true,
  "excludePrivateRecruiters": true,
  "onlyWithSalary": true,
  "maxItems": 200
}
```

**Remote jobs anywhere in Germany paying €70k+:**

```json
{
  "searchTerms": ["Data Engineer", "DevOps", "Cloud Engineer"],
  "remoteOnly": true,
  "minSalaryYearly": 70000,
  "maxItems": 300
}
```

**Apprenticeships (Ausbildung) in Cologne starting next year:**

```json
{
  "searchTerms": ["Elektroniker", "Mechatroniker", "Kaufmann"],
  "location": "Köln",
  "offerType": "apprenticeship",
  "maxItems": 500
}
```

**Daily feed of new nursing jobs in Berlin (schedule daily):**

```json
{
  "searchTerms": ["Pflegefachkraft"],
  "location": "Berlin",
  "postedWithinDays": 1,
  "onlyNewOrUpdated": true,
  "maxItems": 1000
}
```

### 📤 Output example

```json
{
  "jobId": "14225-26618e7843c74fd0-S",
  "title": "Wirtschaftsinformatiker - Abteilungsleiter (m/w/d)",
  "occupation": "Softwareentwickler/in",
  "companyName": "TÜV SÜD Business Service GmbH",
  "postedVia": "jobvector.de",
  "street": "Westendstraße",
  "postalCode": "80686",
  "city": "München",
  "region": "Bayern",
  "country": "Deutschland",
  "latitude": 48.132891,
  "longitude": 11.5210575,
  "remote": false,
  "offerType": "job",
  "fullTime": true,
  "startDate": "2026-10-20",
  "salaryMin": 101695.59,
  "salaryMax": 101695.59,
  "salaryCurrency": "EUR",
  "salaryInterval": "year",
  "isTempAgency": false,
  "isPrivateRecruiter": false,
  "postedAt": "2026-10-18",
  "url": "https://www.arbeitsagentur.de/jobsuche/jobdetail/14225-26618e7843c74fd0-S",
  "externalUrl": "https://www.jobvector.de/job/26618e7843c74fd0/",
  "description": "Innovationen bringen tiefgreifende Veränderungen mit sich…"
}
```

The dataset has two views: **Jobs** and **Employers** (company, website, address, agency flags).

### 💵 Pricing

| Apify plan | Price per 1,000 jobs |
|---|---|
| Free | $2.00 |
| Bronze | $1.80 |
| Silver | $1.50 |
| Gold and above | $1.20 |

No start fee. Jobs removed by your filters, or skipped as unchanged in monitoring mode, are not charged. Apify's free plan includes $5 of monthly credit, about 2,500 jobs.

### 💡 Use cases

- **Job boards and aggregators:** a complete, structured feed of German jobs with salaries and coordinates.
- **Sales prospecting:** find companies hiring for roles your product serves ("who is hiring 5+ warehouse workers in Hesse?"), with their address and website.
- **Recruiting agencies:** spot new openings daily, filtered to direct employers.
- **Salary benchmarking:** stated pay per occupation, region and contract type.
- **Labor market research:** demand by occupation, region, working time and contract, over time.
- **AI agents:** answer "find me a part-time accounting job near Leipzig" with live data.

### 🔌 API and integrations

```bash
curl -X POST "https://api.apify.com/v2/acts/gleanery_actors~arbeitsagentur-jobs-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"searchTerms":["Elektriker"],"location":"Stuttgart","postedWithinDays":7,"maxItems":50}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("gleanery_actors/arbeitsagentur-jobs-scraper").call(
    run_input={"searchTerms": ["Pflegefachkraft"], "location": "Hamburg", "onlyWithSalary": True}
)
for job in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(job["title"], job["companyName"], job["salaryMin"], job["url"])
```

Send results to Google Sheets, Slack, Airtable, Make, Zapier or n8n with Apify integrations.

### ❓ FAQ

**Where does the data come from?**
From the public job search (Jobsuche) of the Bundesagentur für Arbeit at arbeitsagentur.de, the same data job seekers see.

**Should I search in German or English?**
German job titles match best ("Softwareentwickler", "Pflegefachkraft", "Lagerhelfer"). English titles that are common in Germany ("Data Engineer", "Product Manager") work too.

**Why do I get at most 10,000 jobs per search term?**
The job board returns at most 10,000 results per search. For more, split the search by city, add terms, or use `postedWithinDays` with a daily schedule.

**How many jobs have a salary?**
About a quarter. Use `onlyWithSalary` to keep only those.

**Is it legal and GDPR-compliant?**
The actor returns job postings published for job seekers: employer, workplace and job details. It does not collect applicant data or personal profiles. Free-text descriptions may name a contact person exactly as the employer published it; turn off `includeDescription` or cut it with `descriptionMaxLength` if you don't need it.

### 🧰 More data tools from us

- [Job Search API](https://apify.com/gleanery_actors/ats-job-search): jobs from 10,000+ company career sites (Greenhouse, Lever, Ashby…) in one search
- [Career Site Jobs Scraper](https://apify.com/gleanery_actors/career-site-jobs-scraper): every job from specific companies' career sites
- [Wellfound Jobs Scraper](https://apify.com/gleanery_actors/wellfound-jobs-scraper): startup jobs with salary and equity
- [Europages Scraper](https://apify.com/gleanery_actors/europages-scraper): European suppliers and manufacturers with VAT IDs

### 💬 Support

Found a bug or need a field? Open an issue on the **Issues** tab. We reply within 24 hours.

# Actor input Schema

## `searchTerms` (type: `array`):

One search per term, e.g. "Softwareentwickler", "Pflegefachkraft", "Elektriker". German job titles match best; English titles common in Germany ("Data Engineer") work too. Leave empty to get all jobs matching the filters below.

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

City, district or postal code in Germany, e.g. "Berlin", "München", "80331". Empty = all of Germany (and the few foreign jobs listed).

## `radiusKm` (type: `integer`):

Search radius around the location.

## `postedWithinDays` (type: `integer`):

Only jobs published in the last N days. 0 = any time. Use 1 for a daily feed.

## `offerType` (type: `string`):

Regular jobs, apprenticeships (Ausbildung), internships/trainee programs, or self-employment offers.

## `workingTime` (type: `array`):

Any of these. Empty = any.

## `contractType` (type: `string`):

Permanent or fixed-term contracts only. Jobs that don't state it are included only with "Any".

## `excludeTempAgencies` (type: `boolean`):

Drop temporary staffing offers (Arbeitnehmerüberlassung). They are about 40% of some searches.

## `excludePrivateRecruiters` (type: `boolean`):

Drop offers posted by private job placement agencies (private Arbeitsvermittlung), keeping direct employers.

## `remoteOnly` (type: `boolean`):

Only jobs that offer home office.

## `onlyWithSalary` (type: `boolean`):

Only jobs that state pay (about a quarter of all listings).

## `minSalaryYearly` (type: `integer`):

Keep jobs whose stated pay reaches at least this per year. Hourly and monthly pay is converted (2,080 hours, 12 months). Jobs without salary are dropped when set.

## `excludeTitleKeywords` (type: `array`):

e.g. "Werkstudent", "Praktikum", "Senior".

## `excludeCompanies` (type: `array`):

Drop employers whose name contains any of these, e.g. a competitor or an agency you've seen enough of.

## `includeDescription` (type: `boolean`):

Fetch each job's full description, the employer's website and the temp-agency / recruiter flags. Turn off for a faster, lighter list.

## `descriptionMaxLength` (type: `integer`):

Cut descriptions to this many characters. 0 = full text.

## `omitEmptyFields` (type: `boolean`):

Leave out null and empty fields for compact output (useful for AI agents).

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

Stop after this many jobs in total. Caps your cost. The API returns up to 10,000 jobs per search term.

## `onlyNewOrUpdated` (type: `boolean`):

For scheduled runs: return (and charge for) only jobs that are new or were edited since the previous run with the same input.

## `stateKey` (type: `string`):

Optional name for the monitoring memory. Runs with the same key share it.

## Actor input object example

```json
{
  "searchTerms": [
    "Softwareentwickler"
  ],
  "location": "Berlin",
  "radiusKm": 25,
  "postedWithinDays": 0,
  "offerType": "job",
  "contractType": "any",
  "excludeTempAgencies": false,
  "excludePrivateRecruiters": false,
  "remoteOnly": false,
  "onlyWithSalary": false,
  "minSalaryYearly": 0,
  "includeDescription": true,
  "descriptionMaxLength": 0,
  "omitEmptyFields": false,
  "maxItems": 20,
  "onlyNewOrUpdated": false
}
```

# Actor output Schema

## `results` (type: `string`):

All scraped jobs as dataset items (JSON, CSV, Excel).

# 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 = {
    "searchTerms": [
        "Softwareentwickler"
    ],
    "location": "Berlin",
    "maxItems": 20
};

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

# Prepare the Actor input
run_input = {
    "searchTerms": ["Softwareentwickler"],
    "location": "Berlin",
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("gleanery_actors/arbeitsagentur-jobs-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 '{
  "searchTerms": [
    "Softwareentwickler"
  ],
  "location": "Berlin",
  "maxItems": 20
}' |
apify call gleanery_actors/arbeitsagentur-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,gleanery_actors/arbeitsagentur-jobs-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/SjOyNYUgkchQsnJo1/builds/BsqAKRPKallNJcNLV/openapi.json