Kununu

Get reviews for a company on Kununu

get/kununu/reviews

Request

  • Base URL: https://scrappa.co/api
  • URL: https://scrappa.co/api/kununu/reviews
  • Auth: API key in header X-API-KEY

Query parameters

country'de' | 'at' | 'ch' required

Country code of the company (e.g., "de", "at", "ch")

company_slugstring required

Company slug from Kununu (e.g., "bmwgroup", "sap")

company_idstring uuid nullable

Company ID from Kununu (UUID format). Optional; resolved from company_slug when omitted.

uuidstring uuid nullable

Alias for company_id, for chaining from the search endpoint.

slugstring nullable

Alias for company_slug, for chaining from the search endpoint.

countryCode'de' | 'at' | 'ch' | 'null' nullable

Alias for country (de, at, ch).

pageinteger nullable

Page number (default: 1). Kununu currently restricts anonymous access to review pages after page 1: those pages return HTTP 503 with error_code upstream_review_fenced, meta.complete=false and retryable=false, without data, without Retry-After and without billing. Repeating the same request cannot unlock them.

review_type'employees' | 'candidates' | 'null' nullable

Type of reviews: "employees" or "candidates" (default: "employees")

sort'worst' | 'best' | 'newest' | 'oldest' | 'null' nullable

Sort order. "newest" and "oldest" order the full result set by last review activity, which is the creation date unless the review was edited later. "best" and "worst" order each returned page by score while preserving stable, non-overlapping pagination. Omit to use the default kununu relevance ordering. For incremental syncing, compare the updatedAt field rather than createdAt.

recovery'partial' | 'null' nullable

Set to "partial" on fenced page 2 for bounded server-selected filter fanout. Incomplete results return HTTP 503 with data and meta.partial=true; do not paginate them.

score_filters[]string[]

Filter by ratings: ["excellent", "good", "satisfactory", "subpar"]

recommended_filters[]string[]

Filter by recommendation status: ["yes", "no"]

jobstatus_filters[]string[]

Filter by employment status: ["current", "former"]

position_filters[]string[]

Filter by position: ["employee", "manager", "apprentice", "student", "intern", "freelancer", "contractor"]

department_filters[]string[]

Filter by department: ["administration", "sales", "legal", "operations", "recruiting", "communication", "product", "logistic", "it", "management", "research", "controlling", "design", "procurement"]

response_filters[]string[]

Filter by company response: ["yes", "no"]

result_filters[]string[]

Filter candidate reviews by application outcome: ["hired", "rejected", "offerDeclined", "deferred"]

date_filters[]string[]

Filter by date range: ["24months", "12months", "6months", "30days"]

fetch_factor_scoresboolean nullable

Include detailed factor ratings in response (adds ratings array with items like {"id": "workLifeBalance", "score": 4.5, "roundedScore": 5.0, "text": "Work-life balance"})

Response

object required

Changes

No recorded changes to this operation across all 4 revisions of this API.