# Kununu Jobs

Search and filter job listings on Kununu with support for location, workplace model, employment type, career level, industry, discipline, benefits, and more.

- **Documentation:** [https://scrappa.co/docs/kununu-api/kununu_jobs](https://scrappa.co/docs/kununu-api/kununu_jobs)
- **API group:** Kununu API
- **Endpoint:** `GET https://scrappa.co/api/kununu/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 | No | Job title or keyword search (e.g., "Software Engineer") |
| `location` | string | No | City or location name (e.g., "Berlin"). Pass a plain city name and the API will resolve it automatically. |
| `country` | string | No | Country code: de (Germany), at (Austria), ch (Switzerland). Default: de |
| `page` | integer | No | Page number for pagination (default: 1, 30 results per page) |
| `radius` | integer | No | Search radius in km around location. Values: 10, 20, 30, 50, 100, 200 |
| `sort` | string | No | Sort order: "newest" (newest first), "kununuScore" (by company score). Default: relevance |
| `workplace[]` | array | No | Filter by workplace model: FULL_REMOTE (home office), PARTLY_REMOTE (hybrid), NON_REMOTE (on-site) |
| `employment_types[]` | array | No | Filter by employment type: FULL_TIME, PART_TIME, INTERN, TEMPORARY, CONTRACTOR, SEASONAL, VOLUNTARY |
| `career_level[]` | array | No | Filter by career level: 1 (student/intern), 2 (entry-level), 3 (experienced), 4 (manager), 5 (director), 6 (executive), 99 (apprentice) |
| `kununu_score[]` | array | No | Filter by minimum company score range: "4-5", "3-4", "2-3", "1-2" |
| `industry[]` | array | No | Filter by industry ID (1-44). See Kununu Industries endpoint for full list. |
| `discipline[]` | array | No | Filter by discipline/field of activity ID (1001-1022) |
| `benefits[]` | array | No | Filter by company benefits: flexWorkingHours, pensionPlan, coaching, mobilePhone, internet, healthProgram, reachability, events, discounts, parking, car, meals, dogs, daycare, cantine, stockOptions, doctor, accessibility, material, clothes, transportation |
| `is_top_company` | boolean | No | Only show Top Company badge holders (true/false) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/kununu/jobs?query=Software+Engineer&country=de&workplace%5B%5D=FULL_REMOTE"
```

## Example response

```json
{
    "success": true,
    "data": [
        {
            "id": "job-uuid",
            "title": "Senior Software Engineer",
            "url": "https://www.kununu.com/de/job/job-uuid",
            "postedAt": "2026-03-01",
            "city": "Berlin",
            "region": "Berlin",
            "stateCode": "DE-BE",
            "employmentTypes": [
                "JOB_EMPLOYMENT_FULLTIME"
            ],
            "salary": null,
            "recommendationRate": 72,
            "source": "kununu",
            "company": {
                "uuid": "company-uuid",
                "name": "Example GmbH",
                "slug": "example-gmbh",
                "logo": "https://example.com/logo.png",
                "score": 4.1,
                "isTopCompany": false,
                "industryId": 6,
                "website": "https://example.com",
                "countryCode": "de"
            },
            "kununuJobTitle": {
                "id": 12345,
                "title": "Softwareentwickler:in",
                "salaryAverage": 68000,
                "salaryLowerBound": 52000,
                "salaryUpperBound": 90000,
                "salaryDataPoints": 1234
            }
        }
    ],
    "meta": {
        "pagination": {
            "currentPage": 1,
            "lastPage": 68,
            "totalJobs": 2040
        },
        "duration_ms": 234.56,
        "cached": false,
        "cached_at": null,
        "warnings": []
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 401 | Unauthorized | API key is missing or invalid |
| 422 | Validation Error | One or more parameters failed validation |
| 500 | Internal Server Error | Service temporarily unavailable or failed to fetch jobs from Kununu API |

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