{ "openapi": "3.0.1", "info": { "title": "Kununu Scraper - DACH Employer Reviews & Ratings", "description": "Scrape company reviews, ratings, recommendation rates and salary data from kununu.com, the leading employer review platform for Germany, Austria and Switzerland. No login required.", "version": "0.1", "x-build-id": "ThOryxSpEf5h3CERg" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/studio-amba~kununu-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-studio-amba-kununu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/studio-amba~kununu-scraper/runs": { "post": { "operationId": "runs-sync-studio-amba-kununu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/studio-amba~kununu-scraper/run-sync": { "post": { "operationId": "run-sync-studio-amba-kununu-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "companySlugs": { "title": "Company Slugs (optional)", "type": "array", "description": "kununu profile slugs to scrape, e.g. 'lidl-deutschland' from https://www.kununu.com/de/lidl-deutschland. Combine with searchQuery / companyUrls or use alone.", "items": { "type": "string" } }, "companyUrls": { "title": "Company Profile URLs (optional)", "type": "array", "description": "Full kununu.com profile URLs, e.g. 'https://www.kununu.com/de/lidl-deutschland'. Use when you already have the exact profile link (any country).", "items": { "type": "string" } }, "searchQuery": { "title": "Search Query (optional)", "type": "string", "description": "Company name to search for, e.g. 'siemens'. Resolves to the top matching profiles via kununu's search and scrapes each of them." }, "country": { "title": "Country", "enum": [ "de", "at", "ch" ], "type": "string", "description": "Which kununu country site to use for companySlugs (companyUrls and search results carry their own country). 'de' = Germany, 'at' = Austria, 'ch' = Switzerland.", "default": "de" }, "maxReviews": { "title": "Max Reviews Per Company", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of reviews to fetch per company. For a company with more than 20 reviews, kununu shows a logged-out visitor about 50 (the first page plus the newest, best, worst and oldest reviews), so values above 50 return no more for those companies. Smaller companies are scraped in full.", "default": 20 }, "maxResults": { "title": "Max Total Review Rows", "minimum": 1, "maximum": 20000, "type": "integer", "description": "Overall cap on review rows across ALL companies in this run (company-summary rows do not count against this cap).", "default": 200 }, "brightDataApiKey": { "title": "Bright Data API Key", "type": "string", "description": "Your Bright Data API key for the Web Unlocker zone. Required to bypass kununu's AWS WAF Bot Control (CloudFront). Get one at https://brightdata.com. Can also be supplied via the BRIGHT_DATA_API_KEY environment variable." }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Not used — this actor routes all traffic through Bright Data Web Unlocker, not Apify proxies." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }