Get reviews for a company on Kununu
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 code of the company (e.g., "de", "at", "ch")
Company slug from Kununu (e.g., "bmwgroup", "sap")
Company ID from Kununu (UUID format). Optional; resolved from company_slug when omitted.
Alias for company_id, for chaining from the search endpoint.
Alias for company_slug, for chaining from the search endpoint.
Alias for country (de, at, ch).
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.
Type of reviews: "employees" or "candidates" (default: "employees")
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.
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.
Filter by ratings: ["excellent", "good", "satisfactory", "subpar"]
Filter by recommendation status: ["yes", "no"]
Filter by employment status: ["current", "former"]
Filter by position: ["employee", "manager", "apprentice", "student", "intern", "freelancer", "contractor"]
Filter by department: ["administration", "sales", "legal", "operations", "recruiting", "communication", "product", "logistic", "it", "management", "research", "controlling", "design", "procurement"]
Filter by company response: ["yes", "no"]
Filter candidate reviews by application outcome: ["hired", "rejected", "offerDeclined", "deferred"]
Filter by date range: ["24months", "12months", "6months", "30days"]
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
Changes
No recorded changes to this operation across all 4 revisions of this API.