# Kununu Search

Search Kununu companies by brand name, employer keyword, or industry category and return structured employer profile matches from the DACH region.

Use the Kununu Search API to discover company review profiles before fetching deeper employer data such as employee reviews, profile details, ratings, locations, industries, benefits, and open job counts. Filter results by country or industry to build HR tech products, employer reputation dashboards, competitive research workflows, and company-review datasets.

- **Documentation:** [https://scrappa.co/docs/kununu-api/kununu_search](https://scrappa.co/docs/kununu-api/kununu_search)
- **API group:** Kununu API
- **Endpoint:** `GET https://scrappa.co/api/kununu/search`

## 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 | Search query |
| `limit` | integer | No | Max results (1-100) |
| `offset` | integer | No | Number of results to skip (for pagination) |
| `countries[]` | array | No | Country codes filter |
| `industry` | integer | No | Industry ID filter (1-44) |

## Example request

```bash
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/kununu/search?query=BMW"
```

## Example response

```json
{
    "success": true,
    "data": [
        {
            "id": "company-uuid",
            "uuid": "company-uuid",
            "name": "Example Company",
            "slug": "example-company",
            "url": "https://www.kununu.com/de/example-company",
            "logo": "https://example.com/logo.png",
            "industry": 1,
            "searchImage": "https://example.com/search-image.jpg",
            "location": {
                "city": "Munich",
                "countryCode": "de"
            },
            "ratings": {
                "overall": 4.2,
                "rounded": 4
            },
            "reviewCount": 150,
            "totalJobs": 25,
            "isTopCompany": true,
            "benefits": []
        }
    ],
    "meta": {
        "pagination": {
            "currentPage": 1,
            "totalPages": 20,
            "resultsStart": 1,
            "resultsEnd": 10,
            "totalResults": 200,
            "limit": 10,
            "offset": 0
        },
        "filters": {
            "countries": [
                "de",
                "at",
                "ch"
            ]
        },
        "duration_ms": 123.45,
        "cached": false,
        "cached_at": null
    }
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 401 | Unauthorized | API key is missing or invalid |
| 422 | Validation Error | One or more parameters failed validation |
| 404 | Not Found | Requested offset exceeds the available results |
| 500 | Internal Server Error | Service temporarily unavailable or failed to fetch data from Kununu API |

## Frequently asked questions

### What data does the Kununu Search API return?

The search endpoint returns matching Kununu company profiles with fields such as company name, slug, profile URL, location, industry, employer rating, review count, job count, Top Company status, and benefit labels when available.

### Can I filter Kununu company search results by country?

Yes. Pass `countries[]` with supported Kununu market codes such as `de`, `at`, or `ch` to focus search results on Germany, Austria, or Switzerland.

### How does Kununu Search fit with the other Kununu endpoints?

Use search to find the right company slug and profile metadata, then call the company details or reviews endpoints to retrieve deeper employer ratings, employee feedback, and profile data for that company.

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