# Job Search

Search job listings from Germany's Federal Employment Agency with powerful filters. Supports filtering by keyword (was), location (wo), search radius (umkreis), offer type (angebotsart), working hours (arbeitszeit), publication date (veroeffentlichtseit), occupational field (berufsfeld), employer (arbeitgeber), contract type (befristung), temporary work (zeitarbeit), and pagination (page, size).

- **Documentation:** [https://scrappa.co/docs/arbeitsagentur-jobs-api/arbeitsagentur_jobs_search](https://scrappa.co/docs/arbeitsagentur-jobs-api/arbeitsagentur_jobs_search)
- **API group:** Arbeitsagentur Jobs API
- **Endpoint:** `GET https://scrappa.co/api/arbeitsagentur/jobs`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `was` | string | No | Job title, keyword, or occupation to search for (e.g. "Software Entwickler") |
| `wo` | string | No | Location to search in, e.g. city name or postal code (e.g. "Berlin" or "10115") |
| `umkreis` | integer | No | Search radius in kilometers around the specified location (e.g. 25) |
| `angebotsart` | integer | No | Type of job offer: 1 = employment, 2 = self-employment, 4 = apprenticeships/dual study, 34 = internship/trainee |
| `arbeitszeit` | string | No | Working hours type: vz = full-time, tz = part-time, snw = shift/night/weekend, ho = home office, mj = mini job |
| `veroeffentlichtseit` | integer | No | Filter by publication date in days (e.g. 1 = last 24 hours, 7 = last week, 30 = last month) |
| `berufsfeld` | string | No | Occupational field code to filter results by profession category |
| `arbeitgeber` | string | No | Filter by employer/company name |
| `befristung` | integer | No | Contract duration: 1 = fixed-term, 2 = permanent/unlimited |
| `zeitarbeit` | boolean | No | Include temporary work positions: 1 (yes) or 0 (no) |
| `page` | integer | No | Page number for pagination (starts at 1). Pages beyond the available results or upstream pagination limit return 422; narrow the search using location, employer, or publication date filters. |
| `size` | integer | No | Number of results per page (1-100) |
| `pav` | boolean | No | Include listings from private employment agencies: 1 (yes) or 0 (no) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10"
```

## Example response

```json
{
    "success": true,
    "data": {
        "stellenangebote": [
            {
                "refnr": "de:dJobAngebot:10000001",
                "titel": "Software Entwickler (m/w/d)",
                "beruf": "Softwareentwickler/-in",
                "arbeitgeber": "TechGmbH",
                "arbeitsort": {
                    "ort": "Berlin",
                    "plz": "10115",
                    "region": "Berlin",
                    "land": "Deutschland",
                    "koordinaten": {
                        "lat": 52.52,
                        "lon": 13.405
                    }
                },
                "eintrittsdatum": "2026-03-01",
                "aktuelleVeroeffentlichungsdatum": "2026-02-20T08:00:00",
                "externeUrl": "https://www.arbeitsagentur.de/jobsuche/jobdetail/10000001"
            }
        ],
        "maxErgebnisse": "120",
        "page": 1,
        "size": 10,
        "facetten": []
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 422 | One or more job-search parameters failed validation. |  |
| 503 | The VPN-only Arbeitsagentur request could not complete within its bounded retry budget. |  |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)