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).

Endpoint

GET /api/arbeitsagentur/jobs/search
✨

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Parameters

was string Optional

Job title, keyword, or occupation to search for (e.g. "Software Entwickler")

wo string Optional

Location to search in, e.g. city name or postal code (e.g. "Berlin" or "10115")

umkreis integer Optional

Search radius in kilometers around the specified location (e.g. 25)

angebotsart integer Optional

Type of job offer: 1 = employment, 2 = self-employment, 4 = apprenticeships/dual study, 34 = internship/trainee

arbeitszeit string Optional

Working hours type: vz = full-time, tz = part-time, snw = shift/night/weekend, ho = home office, mj = mini job

veroeffentlichtseit integer Optional

Filter by publication date in days (e.g. 1 = last 24 hours, 7 = last week, 30 = last month)

berufsfeld string Optional

Occupational field code to filter results by profession category

arbeitgeber string Optional

Filter by employer/company name

befristung integer Optional

Contract duration: 1 = fixed-term, 2 = permanent/unlimited

zeitarbeit boolean Optional

Include temporary work positions: 1 (yes) or 0 (no)

page integer Optional

Page number for pagination (starts at 1)

size integer Optional

Number of results per page (1-100)

pav boolean Optional

Include listings from private employment agencies: 1 (yes) or 0 (no)

Request Examples

<?php

$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, 'https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'x-api-key: YOUR_API_KEY_HERE',
]);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
<?php

use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
    'x-api-key' => 'YOUR_API_KEY_HERE',
])->get('https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10');

return $response->json();
fetch('https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));
const axios = require('axios');

axios.get('https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10', {
  headers: {
    'x-api-key': 'YOUR_API_KEY_HERE'
  }
})
  .then(response => console.log(response.data))
  .catch(error => console.error('Error:', error));
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE'
}

response = requests.get('https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10', headers=headers)
print(response.json())
require 'net/http'
require 'uri'
require 'json'

uri = URI.parse('https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10')
request = Net::HTTP::Get.new(uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts JSON.parse(response.body)
package main

import (
    "fmt"
    "io/ioutil"
    "net/http"
)

func main() {
    client := &http.Client{}
    req, _ := http.NewRequest("GET", "https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10", nil)
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}
curl -X GET 'https://scrappa.co/api/arbeitsagentur/jobs?was=Software+Entwickler&wo=Berlin&umkreis=25&page=1&size=10' \
  -H 'x-api-key: YOUR_API_KEY_HERE'

Response Schema

JSON Response 200 OK 
{
    "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": []
    }
}

Try It Live

Test this endpoint in our interactive playground with real data.

Open in Playground
← Back to Home