Skip to content
Scrappa Get API key

Kununu Review Lookup

Look up one Kununu review by its stable UUID within the company and review-type scope where it was originally observed. A review_not_found response is only returned after Kununu accepts the exact UUID filter and returns a valid empty result. Upstream blocks, timeouts, errors, and malformed responses are returned as retryable or indeterminate failures and never as a removed review.

Run this endpoint

Kununu Review Lookup 1 credit/request
Get API key Open Playground

Endpoint

GET https://scrappa.co/api/kununu/review
Get API key Open Playground
Request preview GET
https://scrappa.co/api/kununu/review
Auth header x-api-key
Cost 1 credit/request
reviewId = example country = US company_slug = example
Response preview 200 OK 
{
    "meta": {
        "cached": false,
        "confirmed": true,
        "retryable": false,
        "checked_at": "2026-07-13T20:00:00.000000Z"
    },
    "exists": true,
    "review": {
        "uuid": "4ff54c57-fffe-4bc0-a8f5-5b25082a4dac",
        "score": 1,
        "title": "Review title",
        "displayStatus": "SHOW_FULL"
    },
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

4 required parameters needed before sending a request.

2 optional filters available.

reviewId country company_slug review_type
reviewId string Required

Stable Kununu review UUID

Example value example
country string Required

Country code of the company: de, at, or ch

Example value US
company_slug string Required

Company slug where the review was originally observed

Example value example
review_type string Required

Original review collection: employees or candidates

Example value example
company_id string Optional

Company UUID. Optional; resolved from company_slug when omitted.

Example value 1234567890
fetch_factor_scores boolean Optional

Include detailed factor ratings when the review exists

Example value true

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Open in Playground

Example response fields

Scan these fields before integrating.

meta exists review status success
JSON Response
200 OK 
{
    "meta": {
        "cached": false,
        "confirmed": true,
        "retryable": false,
        "checked_at": "2026-07-13T20:00:00.000000Z"
    },
    "exists": true,
    "review": {
        "uuid": "4ff54c57-fffe-4bc0-a8f5-5b25082a4dac",
        "score": 1,
        "title": "Review title",
        "displayStatus": "SHOW_FULL"
    },
    "status": "exists",
    "success": true
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

404

Review not found

Kununu returned a valid empty exact-UUID result for the supplied scope.

{
    "meta": {
        "confirmed": true,
        "retryable": false
    },
    "exists": false,
    "review": null,
    "status": "review_not_found",
    "success": false
}
503

Upstream unavailable

Kununu failed, blocked, or limited the request. The review state is unknown.

{
    "meta": {
        "confirmed": false,
        "retryable": true
    },
    "exists": null,
    "review": null,
    "status": "upstream_unavailable",
    "success": false
}
502

Malformed upstream response

Kununu returned an unexpected payload or did not honor the UUID filter. The review state is unknown.

{
    "meta": {
        "confirmed": false,
        "retryable": true
    },
    "exists": null,
    "review": null,
    "status": "malformed_upstream_response",
    "success": false
}
✨

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.

Try It Live

Test this endpoint in our interactive playground with real data.

Get API key Open Playground
← Back to Home