# Germany Jobs Scraper: Arbeitsagentur Jobbörse API (1M+ Jobs) (`latamdatatools/germany-jobs-arbeitsagentur`) Actor

Scrape job ads from the official Jobbörse of the Bundesagentur für Arbeit (1M+ German jobs) through its public API: keyword and city search with radius, work time, contract, salary, home office, coordinates, full description and only-new alerts. No contact persons.

- **URL**: https://apify.com/latamdatatools/germany-jobs-arbeitsagentur.md
- **Developed by:** [Julian Genuario](https://apify.com/latamdatatools) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.60 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## Germany Jobs Scraper: Arbeitsagentur Jobbörse API (1M+ Jobs)

Get **job ads from Germany's largest job board**, the official **Jobbörse of the Bundesagentur für Arbeit** (Federal Employment Agency), with more than **1 million open positions**, as a clean spreadsheet or API feed:

- **Search** by job title or keyword and **city, postal code or region with radius**, for jobs, internships / trainee programs or self-employment.
- **Filters**: published in the last N days, full-time / part-time / shift / home office / mini-job, permanent or fixed-term, no temporary agencies (Zeitarbeit), no private recruiters, employer name.
- **Data per job**: title, company, occupation, city, ZIP, region, **coordinates**, all locations, distance, work time, **salary** (when given, with period), home office %, contract type and duration, start date, publication and update dates, link to the ad and the employer's external link.
- **Full description** (optional) with temporary-agency and private-recruiter flags.
- **Only new jobs** since the last run, for daily alerts.

It uses the **public REST API** of the Bundesagentur (the same one its website uses), not page scraping: fast, stable and complete.

### What does Germany Jobs Scraper do?

It is an **Arbeitsagentur scraper / Jobbörse API client** for job market research, recruiting, lead generation (companies that are hiring) and job aggregators. Each keyword is searched in each location, results are deduplicated across searches, and every row has the same English field names.

### Who uses it

- **Recruiters and staffing agencies**: find companies hiring for a role in a region, every morning.
- **Job boards and aggregators**: import German jobs with coordinates and salary.
- **Sales teams (B2B lead generation)**: companies that hire developers, nurses or drivers are companies that grow.
- **Labour-market researchers and journalists**: salaries, home-office share and contract types by occupation and region.

### How to use it

1. Click **Try for free** (a free Apify account is enough).
2. Type job titles (one per line) and locations, and pick the filters.
3. Click **Start**.
4. Download the results from the **Output** tab as JSON, CSV, Excel or HTML, or read them with the API.
5. For alerts: turn on **Only new jobs**, give the search an alert name and **schedule** the task daily. Connect Slack, e-mail or Google Sheets with Apify integrations.

### Input

```json
{
  "keywords": ["Softwareentwickler", "Data Scientist"],
  "locations": ["Berlin", "München"],
  "radiusKm": 25,
  "offerType": "job",
  "publishedWithinDays": 7,
  "workTime": ["fullTime"],
  "contract": "permanent",
  "excludeTempAgencies": true,
  "includeDetails": true,
  "onlyNew": false,
  "maxItems": 1000
}
```

### Output

```json
{
  "referenceNumber": "10001-1003891446-S",
  "title": "Softwareentwicklerin (w/m/d)",
  "company": "GASAG AG",
  "occupation": "Softwareentwickler/in",
  "offerType": "ARBEIT",
  "city": "Berlin",
  "postalCode": "10829",
  "region": "BERLIN",
  "lat": 52.480611,
  "lon": 13.356027,
  "distanceKm": 6,
  "workTime": ["full-time"],
  "homeOffice": true,
  "homeOfficePercent": 50,
  "contractDuration": "BEFRISTET",
  "fixedTermMonths": 24,
  "salary": 72600,
  "salaryPeriod": "year",
  "startDate": "2026-10-22",
  "publishedAt": "2026-10-21",
  "temporaryAgency": false,
  "privateRecruiter": false,
  "url": "https://www.arbeitsagentur.de/jobsuche/jobdetail/10001-1003891446-S",
  "description": "Wir suchen dich an unserem Standort in Berlin ...",
  "matchedKeyword": "Softwareentwickler",
  "source": "Bundesagentur für Arbeit (Jobbörse)"
}
```

### Pricing

Pay per event:

- **USD 0.60 per 1,000 jobs** (`job`).
- **+ USD 0.40 per 1,000 full descriptions** (`detail`), only when "Full job description" is on and the description was retrieved.

Not charged: duplicates across your searches and, with "Only new", jobs already delivered in earlier runs. Your **max charge per run** is respected.

### Privacy

Only company-level data is returned. The API's contact-person fields are never read, and e-mail addresses and phone numbers are removed from descriptions. The data comes from the Bundesagentur für Arbeit (credit it as the source).

### Limitations

- The API returns at most **10,000 results per search**: split very broad searches by region or keyword.
- Salary is only present when the employer published it (a minority of ads).
- Locations must be in Germany; unknown place names are reported in the run summary.

### Why this Actor

- **Official API, not page scraping**: the same public REST API the Arbeitsagentur website uses. No proxies, no browser, no blocked runs.
- **No search URL needed**: type job titles and cities; every keyword is searched in every location and the results are deduplicated.
- **Simple, low price**: USD 0.60 per 1,000 jobs, and USD 0.40 per 1,000 full descriptions only if you turn them on. No start fee worth mentioning (USD 0.00005).
- **Daily alerts that cost cents**: with *Only new jobs* you pay only for ads you have not seen yet.

### Cost examples (measured)

| Run | Rows | Cost |
|---|---|---|
| "Softwareentwickler" in Berlin, last 7 days, with full descriptions | 45 jobs + 45 descriptions | about **USD 0.045** |
| All jobs in Germany, default limit (1,000) | 982 jobs (duplicates free) | about **USD 0.59** |
| 20 job titles x 5 cities, daily, *Only new jobs* | usually 100-400 new jobs a day | **USD 0.06-0.24 a day** |

### Use it from your code, an integration or an AI agent

```python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("latamdatatools/germany-jobs-arbeitsagentur").call(run_input={
    "keywords": ["Pflegefachkraft", "Softwareentwickler"],
    "locations": ["Hamburg", "München"],
    "publishedWithinDays": 7,
    "excludeTempAgencies": True,
})
for job in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(job["company"], job["title"], job["city"], job["salary"])
```

- **Schedules + Only new jobs** = a daily feed. Send it to **Google Sheets, Slack, HubSpot, Make, Zapier or n8n** from the Integrations tab.
- **AI agents**: use it as a tool from Claude, Cursor and other MCP clients through the Apify MCP server (`mcp.apify.com`).

### FAQ

**Is there an official API?** Yes: the Jobbörse is served by the BA's public REST API (documented by the community at bund.dev). This Actor uses it with polite pacing (about 4 requests per second).

**Can I call it from my own code or from an AI agent?** Yes, with the Apify API, the JavaScript / Python clients, or as a tool from Claude, Cursor and other MCP clients through the Apify MCP server (`mcp.apify.com`).

**Which export formats are available?** JSON, JSONL, CSV, Excel (XLSX), XML, RSS and HTML table.

# Actor input Schema

## `keywords` (type: `array`):

One search per keyword (German or English job titles work: "Softwareentwickler", "Pflegefachkraft", "Data Scientist"). Leave empty for all jobs in the locations.

## `locations` (type: `array`):

German cities, postal codes or regions ("Berlin", "80331", "Bayern"). Each keyword is searched in each location. Leave empty for all of Germany.

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

Distance around each location.

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

Jobs, self-employment offers or internships / trainee programs. For apprenticeships (Ausbildung) use the Germany Apprenticeships Actor.

## `publishedWithinDays` (type: `integer`):

0 = any date. Max 100.

## `workTime` (type: `array`):

Any of: fullTime, partTime, shiftNightWeekend, homeOffice, miniJob. Empty = all.

## `contract` (type: `string`):

Permanent or fixed-term only.

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

Drop ads from temporary staffing agencies (Arbeitnehmerüberlassung).

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

Drop ads posted by private recruitment agencies (private Arbeitsvermittlung).

## `employer` (type: `string`):

Optional. Only jobs of this company (as written in the Jobbörse).

## `includeDetails` (type: `boolean`):

One extra request per job for the full text, temporary-agency and private-recruiter flags. Charged as a separate small event. E-mails and phone numbers are removed from the text.

## `onlyNew` (type: `boolean`):

Remembers delivered jobs (per alert name) so scheduled runs return only new ones. Already delivered jobs are free.

## `alertName` (type: `string`):

Separate memory for each saved search when using "Only new".

## `maxItemsPerSearch` (type: `integer`):

Per keyword x location. The API returns at most 10,000 per search.

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

Max jobs in total

## Actor input object example

```json
{
  "keywords": [
    "Softwareentwickler"
  ],
  "locations": [
    "Berlin"
  ],
  "radiusKm": 25,
  "offerType": "job",
  "publishedWithinDays": 0,
  "contract": "",
  "excludeTempAgencies": false,
  "excludePrivateRecruiters": false,
  "includeDetails": false,
  "onlyNew": false,
  "alertName": "default",
  "maxItemsPerSearch": 1000,
  "maxItems": 1000
}
```

# Actor output Schema

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

No description

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

// Prepare Actor input
const input = {
    "keywords": [
        "Softwareentwickler"
    ],
    "locations": [
        "Berlin"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("latamdatatools/germany-jobs-arbeitsagentur").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 = {
    "keywords": ["Softwareentwickler"],
    "locations": ["Berlin"],
}

# Run the Actor and wait for it to finish
run = client.actor("latamdatatools/germany-jobs-arbeitsagentur").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 '{
  "keywords": [
    "Softwareentwickler"
  ],
  "locations": [
    "Berlin"
  ]
}' |
apify call latamdatatools/germany-jobs-arbeitsagentur --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,latamdatatools/germany-jobs-arbeitsagentur"
        }
    }
}
```

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/jck0y5hVO65GaRh0f/builds/8kbzkemwRRw7lYv6u/openapi.json