# Arbeitsagentur Jobs Scraper: Bundesagentur für Arbeit API (`plainrows/arbeitsagentur-jobs-scraper`) Actor

German jobs from the official Arbeitsagentur Jobbörse API by keyword + place: title, company, address, occupation, full/part-time, remote, salary when given, dates, link. No login. Pay per job ($0.0009 or less) plus a $0.001 start fee per run.

- **URL**: https://apify.com/plainrows/arbeitsagentur-jobs-scraper.md
- **Developed by:** [PlainRows](https://apify.com/plainrows) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 3 total users, 2 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.
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 (Bundesagentur für Arbeit Jobbörse API)

Get **German job ads from the Jobbörse of the Bundesagentur für Arbeit** (arbeitsagentur.de), the largest job board in Germany, for any keyword and place: **job title, company, work address (street, postal code, city, state, coordinates), occupation, offer type, full-time / part-time, home office, contract duration, salary when the ad gives it, start and publication dates, and link**. Type keywords + German places with a radius and filters, or paste Jobbörse search URLs.

The Actor uses the **official public job search API** of the Bundesagentur für Arbeit (the one behind the Jobbörse website, documented on jobsuche.api.bund.dev): **no login, no account, no browser, no proxy**. It reads one page of 100 jobs at a time per search, with a pause between pages.

### Typical uses

- **German job market research**: how many data, nursing, logistics or engineering jobs are open in Berlin, Munich or Hamburg, with which salary and working time.
- **Recruitment agencies and sales teams**: which German companies are hiring, for what, where (lead lists with company and work address).
- **Job boards and alerts**: feed new German jobs into your own site, Slack, Google Sheets or an AI agent every day (`publishedWithinDays: 1`).
- **Salary and remote analysis**: share of ads with a salary range, of part-time or home-office jobs in your field.
- **Spreadsheets, BI and AI agents**: clean rows for Google Sheets, n8n, Make, Zapier or an MCP client.

### What you get

One row per job ad:

| Field | Description |
|---|---|
| `search`, `query`, `location` | Your search, the keyword and the place searched |
| `referenceNumber`, `url` | Reference number of the ad (unique) and link to the ad on arbeitsagentur.de |
| `externalUrl` | Link to the partner job board when the ad comes from one (tracking parameters removed) |
| `jobTitle` | Job title |
| `company` | Employer of the ad (never a contact person) |
| `occupation`, `occupations` | Main occupation and all occupations of the ad |
| `street`, `postalCode`, `city`, `district`, `region`, `country` | Work address as the ad gives it (state names like `Nordrhein-Westfalen`, country `Germany` or `Austria`) |
| `latitude`, `longitude`, `distanceKm` | Coordinates of the work place, distance from the place searched |
| `otherCities` | Other work places of the same ad |
| `offerType` | `Job`, `Apprenticeship / dual study`, `Internship / trainee` or `Self-employment` |
| `fullTime`, `workingTimes`, `miniJob` | Full-time flag; all working times (`Part-time (morning)`, `Shift, night or weekend`…); mini job |
| `remotePossible`, `remoteType`, `remotePercent` | Home office possible, how (`By arrangement`…), share in percent when given |
| `contractDuration`, `fixedTermMonths`, `fixedTermUntil` | `Permanent` or `Fixed-term`, and its length when given |
| `salaryInfo`, `salaryMin`, `salaryMax`, `salaryCurrency` | `Yearly salary`, `Hourly wage`…, with the range in EUR when the ad gives it |
| `careerChangersWelcome` | Suitable for career changers (Quereinstieg) |
| `startDate`, `publishedAt`, `firstPublishedAt`, `updatedAt` | Start date, current and first publication, last change |
| `page`, `position`, `totalResults` | Where the job was, and how many jobs the API reports |
| `observedAt` | When the API was read (UTC) |

Missing values are always `null`, never guessed. No contact name, e-mail or phone number is collected. A search without jobs (or refused, or unreadable) gets one free row with `found: false`, a `status` and a `message`.

#### Example row

```json
{
  "search": "Data Engineer in Berlin",
  "found": true,
  "referenceNumber": "16752-r5446-S",
  "jobTitle": "Data Engineer* / Machine Learning Engineer*",
  "company": "inovex GmbH",
  "url": "https://www.arbeitsagentur.de/jobsuche/jobdetail/16752-r5446-S",
  "occupation": "Data Engineer",
  "city": "Berlin",
  "region": "Berlin",
  "country": "Germany",
  "latitude": 52.4926833,
  "longitude": 13.4025753,
  "offerType": "Job",
  "fullTime": true,
  "workingTimes": ["Full-time"],
  "salaryInfo": "Yearly salary",
  "salaryMin": 65000,
  "salaryMax": 75000,
  "salaryCurrency": "EUR",
  "startDate": "2026-08-10",
  "publishedAt": "2026-01-21",
  "firstPublishedAt": "2025-05-22",
  "distanceKm": 3,
  "status": "FOUND"
}
```

### Input

```json
{
  "keywords": ["Data Engineer", "Pflegefachkraft"],
  "locations": ["Berlin", "München"],
  "radiusKm": 25,
  "offerType": "job",
  "workingTime": ["fullTime", "homeOffice"],
  "publishedWithinDays": 7,
  "maxJobsPerSearch": 200
}
```

- **keywords** and **locations**: each keyword is searched in each place (town, postal code or region). With no place, across Germany; with places but no keyword, all jobs of those places.
- **radiusKm**: 0 to 200 km around each place (default 25), like the Jobbörse.
- **offerType**: `any` (default), `job`, `apprenticeship`, `internship` or `self-employment`.
- **workingTime**: any of `fullTime`, `partTime`, `shiftNightWeekend`, `homeOffice`, `miniJob`.
- **publishedWithinDays**: only jobs published in the last 0 to 100 days.
- **maxJobsPerSearch**: 1 to 10,000 (default 100). The API returns 100 jobs per page and stops at 10,000 jobs per search: split a larger search by place or filter.
- **searchUrls**: Jobbörse search pages (`https://www.arbeitsagentur.de/jobsuche/suche?was=…&wo=…`) with their own filters.

Up to 100 searches per run. Jobs found by two of your searches are returned and billed once.

### Pricing

Pay per event: **one event per job returned**, plus a small start fee per run ($0.001).

| Plan | Per job | Per 1,000 jobs |
|---|---|---|
| Free | $0.0009 | $0.90 |
| Bronze | $0.0008 | $0.80 |
| Silver | $0.0007 | $0.70 |
| Gold | $0.0006 | $0.60 |

Free: searches without jobs, answers that are refused or cannot be read, ads without a company or reference number, duplicates and input mistakes. On the free Apify plan, a run reads up to 3 searches and 20 jobs per search.

### FAQ

**Is it legal?** The Actor uses the official public job search API of the Bundesagentur für Arbeit, a German federal agency, with its public access key, at a slow pace. It returns job ads that anyone can see on arbeitsagentur.de without an account, and no personal data: no contact person, e-mail or phone number. You are responsible for how you use the data.

**Does it return the full job description?** Not yet: the search API gives every field above but not the description text. Open `url` for the full ad. A version that also reads the description is planned if users ask for it.

**Why only 10,000 jobs per search?** The API itself stops there. Split a broad search (e.g. all jobs in Germany) by place, offer type or working time.

**Are Austrian or other foreign jobs included?** Yes when the Jobbörse lists them for your search (some German employers post jobs in Austria): see `country`. Add a German place to stay in Germany.

**Which language?** Labels (offer type, working time, contract duration, salary type) are in English; titles and occupations stay in German, as published.

**Why are some searches empty or BLOCKED?** If the API refuses a request (rate limit), the Actor stops that search and charges nothing beyond the results already delivered. If this happens after the first page, the run summary warns that the search stopped early and its results are partial. Try again later.

### More PlainRows tools

Same pay-per-result pricing, same clean JSON, built to chain together in n8n, Make, Zapier or AI agents.

- **SEO and keywords:** [Keyword Search Volume, CPC & Difficulty](https://apify.com/plainrows/keyword-search-volume) · [Keyword Planner Alternative (Bulk Search Volume & CPC)](https://apify.com/plainrows/keyword-planner-alternative) · [Bing Keyword Search Volume & CPC](https://apify.com/plainrows/bing-keyword-search-volume) · [Keyword Ideas Generator](https://apify.com/plainrows/keyword-ideas-generator) · [Google Autocomplete & People Also Ask](https://apify.com/plainrows/google-autocomplete-questions) · [Google Trends Explorer](https://apify.com/plainrows/google-trends-explorer) · [Website Organic Traffic & Top Keywords](https://apify.com/plainrows/domain-seo-overview) · [SEO Competitors & Keyword Gap Finder](https://apify.com/plainrows/seo-competitors-keyword-gap) · [Bulk Domain Authority Checker](https://apify.com/plainrows/domain-authority-checker) · [Backlink Checker](https://apify.com/plainrows/backlink-checker) · [Broken Link Checker](https://apify.com/plainrows/broken-link-checker) · [AI Search Visibility Tracker (ChatGPT, Gemini, AI Mode)](https://apify.com/plainrows/ai-search-brand-visibility) · [Google Maps Rank Tracker (Geo-Grid Local SEO)](https://apify.com/plainrows/google-maps-rank-tracker)
- **Leads and companies:** [Google Maps Scraper](https://apify.com/plainrows/google-maps-businesses) · [Google Maps Email Extractor](https://apify.com/plainrows/google-maps-email-extractor) · [Google Maps Businesses Without Website](https://apify.com/plainrows/google-maps-no-website-leads) · [Yellow Pages Australia Scraper](https://apify.com/plainrows/yellowpages-au-scraper) · [Website Technology Checker](https://apify.com/plainrows/website-tech-stack) · [Website Email Extractor](https://apify.com/plainrows/website-email-extractor) · [Contact Details Scraper (Emails, Phones, Socials)](https://apify.com/plainrows/contact-details-scraper) · [ATS Jobs Scraper (Workday, Greenhouse, Lever, Ashby)](https://apify.com/plainrows/ats-job-postings) · [Workday Jobs Scraper](https://apify.com/plainrows/workday-jobs-scraper) · [Greenhouse Jobs Scraper](https://apify.com/plainrows/greenhouse-jobs-scraper) · [Lever Jobs Scraper](https://apify.com/plainrows/lever-jobs-scraper) · [Ashby Jobs Scraper](https://apify.com/plainrows/ashby-jobs-scraper) · [Google Jobs Scraper](https://apify.com/plainrows/google-jobs-scraper) · [Reed.co.uk Jobs Scraper (UK)](https://apify.com/plainrows/reed-jobs-scraper) · [Google Ads Scraper (Transparency Center)](https://apify.com/plainrows/google-ads-transparency) · [Company Registry Lookup (SIRENE, LEI, Brreg)](https://apify.com/plainrows/company-registry-lookup) · [Public Tenders Search (EU TED & UK)](https://apify.com/plainrows/public-tenders-search)
- **E-commerce and travel:** [Amazon Product Search Scraper](https://apify.com/plainrows/amazon-product-search) · [Amazon Best Sellers Scraper](https://apify.com/plainrows/amazon-bestsellers-scraper) · [Amazon Reviews Scraper](https://apify.com/plainrows/amazon-reviews-scraper) · [Google Shopping Prices Scraper](https://apify.com/plainrows/google-shopping-prices) · [Google Hotels Prices Scraper](https://apify.com/plainrows/google-hotels-prices) · [Google Hotels Scraper](https://apify.com/plainrows/google-hotels-scraper) · [Tripadvisor Reviews Scraper](https://apify.com/plainrows/tripadvisor-reviews) · [Trustpilot Reviews Scraper](https://apify.com/plainrows/trustpilot-reviews)
- **Marketplaces and classifieds:** [AliExpress Scraper](https://apify.com/plainrows/aliexpress-scraper) · [Kleinanzeigen Scraper (Germany)](https://apify.com/plainrows/kleinanzeigen-scraper) · [AutoScout24 Scraper (Cars, Europe)](https://apify.com/plainrows/autoscout24-scraper) · [Kijiji Scraper (Canada)](https://apify.com/plainrows/kijiji-scraper) · [Marktplaats Scraper (Netherlands)](https://apify.com/plainrows/marktplaats-scraper) · [Property Finder Scraper (UAE)](https://apify.com/plainrows/propertyfinder-scraper) · [Redfin Scraper (US Homes for Sale)](https://apify.com/plainrows/redfin-scraper) · [Otomoto Scraper (Polish Car Listings)](https://apify.com/plainrows/otomoto-scraper) · [Otodom Scraper (Poland Property)](https://apify.com/plainrows/otodom-scraper) · [Imovirtual Scraper (Portugal Property)](https://apify.com/plainrows/imovirtual-scraper) · [Standvirtual Scraper (Portugal Cars)](https://apify.com/plainrows/standvirtual-scraper) · [Blocket Scraper (Sweden)](https://apify.com/plainrows/blocket-scraper) · [FINN.no Scraper (Norway)](https://apify.com/plainrows/finn-scraper) · [coches.net Scraper (Spain Cars)](https://apify.com/plainrows/coches-net-scraper) · [2dehands Scraper (Belgium)](https://apify.com/plainrows/2dehands-scraper) · [Storia Scraper (Romania Property)](https://apify.com/plainrows/storia-scraper) · [FINN.no Car Scraper (Norway Cars)](https://apify.com/plainrows/finn-cars-scraper) · [DBA Scraper (Denmark)](https://apify.com/plainrows/dba-scraper)
- **Content and media:** [Google News Scraper](https://apify.com/plainrows/google-news-scraper) · [YouTube Search Scraper](https://apify.com/plainrows/youtube-search-scraper) · [YouTube Search API (JSON)](https://apify.com/plainrows/youtube-search-api) · [YouTube Comments Scraper](https://apify.com/plainrows/youtube-comments-scraper) · [Google Images Scraper](https://apify.com/plainrows/google-images-scraper) · [Website Screenshot API](https://apify.com/plainrows/website-screenshot) · [Google Maps Reviews Scraper](https://apify.com/plainrows/google-maps-reviews) · [Google Reviews Scraper](https://apify.com/plainrows/google-reviews-scraper) · [App Store & Google Play Reviews Scraper](https://apify.com/plainrows/app-reviews-scraper) · [Google Play Reviews Scraper](https://apify.com/plainrows/google-play-reviews-scraper) · [App Store Reviews Scraper](https://apify.com/plainrows/app-store-reviews-scraper)

### Support

Open an issue on the Actor's page: issues are read and answered. Need another field, a higher limit or a custom version for your workflow? Ask in an issue.

# Actor input Schema

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

Job titles, occupations or skills, in German or English ("Data Engineer", "Pflegefachkraft", "Lagerhelfer"). Each keyword is searched in each place below. Leave empty to list all jobs of the places.

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

German towns, postal codes or regions ("Berlin", "80331", "Hamburg"), searched with the radius below. Leave empty to search all of Germany.

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

Distance around each place, as on the Jobbörse (0 = the place only). Used only with places.

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

Kind of offer, as the Jobbörse filter Angebotsart.

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

Keep only jobs with one of these working times. Leave empty for all.

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

Only jobs published (or republished) in the last N days, 0 to 100. Leave empty for all. Use 1 for a daily feed of new jobs.

## `maxJobsPerSearch` (type: `integer`):

The API returns 100 jobs per page and at most 10,000 jobs per search; the Actor reads the pages one after the other.

## `searchUrls` (type: `array`):

Search pages copied from the Jobbörse, e.g. https://www.arbeitsagentur.de/jobsuche/suche?angebotsart=1\&was=Koch\&wo=Hamburg\&umkreis=25. Their filters (was, wo, umkreis, angebotsart, arbeitszeit, veroeffentlichtseit, befristung, zeitarbeit…) are kept; the filters above do not apply to them. Up to 100 searches per run.

## Actor input object example

```json
{
  "keywords": [
    "Data Engineer"
  ],
  "locations": [
    "Berlin"
  ],
  "radiusKm": 25,
  "offerType": "any",
  "maxJobsPerSearch": 150
}
```

# Actor output Schema

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

No description

## `summary` (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": [
        "Data Engineer"
    ],
    "locations": [
        "Berlin"
    ],
    "maxJobsPerSearch": 150
};

// Run the Actor and wait for it to finish
const run = await client.actor("plainrows/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 = {
    "keywords": ["Data Engineer"],
    "locations": ["Berlin"],
    "maxJobsPerSearch": 150,
}

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

```

## MCP server setup

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