# Jobs Filters

Return the public filter taxonomy for the German job board. The live response contains ten facet groups with their ids, titles, types, items, itemsUrlParam and options. This is reference data only. The jobs search does not accept facet ids as request parameters.

- **Documentation:** [https://scrappa.co/docs/stepstone-jobs-api/stepstone_filters](https://scrappa.co/docs/stepstone-jobs-api/stepstone_filters)
- **API group:** Stepstone Jobs API
- **Endpoint:** `GET https://scrappa.co/api/stepstone/filters`

## 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 |
| --- | --- | --- | --- |
| `country` | string | No | Country code. Supported value: de (Germany). Default: de |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/stepstone/filters?country=de"
```

## Example response

```json
{
    "success": true,
    "data": {
        "filters": [
            {
                "id": "CATEGORIES",
                "title": "Job categories",
                "type": "LIST",
                "items": [
                    {
                        "id": 123,
                        "label": "Software Development"
                    }
                ],
                "itemsUrlParam": "category",
                "options": [
                    {
                        "id": 123,
                        "label": "Software Development"
                    }
                ]
            }
        ],
        "metadata": {
            "country": "de",
            "timestamp": "2026-11-20T10:00:00Z"
        }
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 503 | Filters Temporarily Unavailable | The upstream could not complete the request. This response is not billed. |

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