# Jobs Search

Search job listings on Stepstone with keyword, location, and filter support. Covers Germany (de), Austria (at), Netherlands (nl), and Belgium (be).

- **Documentation:** [https://scrappa.co/docs/stepstone-jobs-api/stepstone_jobs](https://scrappa.co/docs/stepstone-jobs-api/stepstone_jobs)
- **API group:** Stepstone Jobs API
- **Endpoint:** `GET https://scrappa.co/api/stepstone/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 |
| --- | --- | --- | --- |
| `query` | string | Yes | Job title, skill, or keyword (e.g. "Software Engineer", "Python") |
| `location` | string | No | City or region (e.g. "Berlin", "München") |
| `country` | string | No | Country code: de (Germany), at (Austria), nl (Netherlands), be (Belgium). Default: de |
| `sort` | string | No | Sort order: relevance (default) or date |
| `radius` | integer | No | Search radius in kilometres (e.g. 30) |
| `job_type` | string | No | Filter by type: full_time, part_time, internship, freelance |
| `work_from_home` | boolean | No | Filter for remote/work-from-home jobs (true/false) |
| `date_posted` | integer | No | Maximum age of posting in days: 1, 3, 7, 30 |
| `page` | integer | No | Page number for pagination (default: 1) |
| `limit` | integer | No | Max results to return (1–100, default: 25) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/stepstone/jobs?query=Software+Engineer&location=Berlin&country=de&sort=date&limit=25"
```

## Example response

```json
{
    "success": true,
    "data": {
        "jobs": [
            {
                "id": "12345678",
                "title": "Senior Software Engineer (m/w/d)",
                "url": "https://www.stepstone.de/stellenangebote--Senior-Software-Engineer-Berlin--12345678-inline.html",
                "company": {
                    "id": 9876,
                    "name": "TechGmbH",
                    "logo_url": "https://cdn.stepstone.de/logo/9876.png",
                    "url": "https://www.stepstone.de/cmp/techgmbh"
                },
                "location": {
                    "formatted": "Berlin",
                    "city": "Berlin",
                    "region": null,
                    "country": null
                },
                "salary": null,
                "date_posted": "2026-03-19T08:00:00+01:00",
                "description": "We are looking for a Senior Software Engineer...",
                "skills": [
                    "Python",
                    "Docker",
                    "Kubernetes"
                ],
                "labels": [
                    "Home-Office m\u00f6glich"
                ],
                "work_from_home": true,
                "is_highlighted": false,
                "is_sponsored": false
            }
        ],
        "pagination": {
            "current_page": 1,
            "total_pages": 210,
            "total_jobs": 5234,
            "has_more": true,
            "next_page": 2
        },
        "metadata": {
            "query": "Software Engineer",
            "location": "Berlin",
            "country": "de",
            "timestamp": "2026-03-20T10:00:00Z"
        }
    }
}
```

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