{ "openapi": "3.0.1", "info": { "title": "Kununu Reviews Scraper", "description": "Scrape company reviews, job salaries, HR responses, ratings, and timestamps. Fast, reliable, and built for scaling.\nPerfect for HR analytics, employer branding, and competitor research.\nExport clean data as JSON, CSV, XLSX, or JSONL.", "version": "0.0", "x-build-id": "Z8XDLs6NI3z1chQdW" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/radeance~kununu-reviews-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-radeance-kununu-reviews-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/radeance~kununu-reviews-scraper/runs": { "post": { "operationId": "runs-sync-radeance-kununu-reviews-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/radeance~kununu-reviews-scraper/run-sync": { "post": { "operationId": "run-sync-radeance-kununu-reviews-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", "required": [ "companies" ], "properties": { "companies": { "title": "Kununu Company Page URL, Company Slug or Company Name", "type": "array", "description": "Company reviews URL or company slug to scrape. You can specify multiple URLs or slugs by clicking on the Add button or in bulk by clicking on the Bulk edit button.", "items": { "type": "string" } }, "reviewType": { "title": "Review Type", "enum": [ "all", "employees", "candidates" ], "type": "string", "description": "Select the type of reviews to scrape. Default is all reviews. You can select between all reviews, employee reviews, and application reviews.", "default": "all" }, "review_posted": { "title": "Review(s) posted in last", "pattern": "^(\\d+)\\s*(day|week|month|year)s?$", "type": "string", "description": "Select relative date in format: {number} {unit}" }, "max_reviews": { "title": "Max Reviews per Company", "minimum": 1, "maximum": 50000, "type": "integer", "description": "The maximum number of reviews to scrape from a company of every review type. Defaults to 10. If there are no more reviews to scrape, the actor will stop even if this number is not reached. If you want to scrape all pages, set it to a high number like 50000.", "default": 10 }, "max_salaries": { "title": "Max Salary Reports per Company", "minimum": 1, "maximum": 10000, "type": "integer", "description": "The maximum number of salary reports to scrape from a company. Defaults to 20. If there are no more salary reports to scrape, the actor will stop even if this number is not reached.", "default": 20 }, "include_reviews": { "title": "Include Company Reviews", "type": "boolean", "description": "If set to true, the actor will scrape company reviews. Defaults to true.", "default": true }, "include_salaries": { "title": "Include Job Salaries & Salary Reviews", "type": "boolean", "description": "If set to true, the actor will scrape company job salaries and salary reviews. Defaults to true.", "default": true }, "format": { "title": "Output Format", "enum": [ "formatted", "raw" ], "type": "string", "description": "Select desired output format. Default is formatted, which includes all data in a structured format. Raw will return only the raw output data.", "default": "formatted" }, "stream_output": { "title": "Stream Output", "type": "boolean", "description": "If checked, the scraper will stream the data to the dataset as it scrapes. This is useful for large queries. Default: true", "default": true }, "storage_name": { "title": "Name of the Storage for the dataset", "pattern": "^[a-zA-Z0-9-]+$", "minLength": 3, "maxLength": 32, "type": "string", "description": "Saves your dataset to a specific storage name. It is recommended to use a unique name for longer storage retention. If not provided, your data will be saved for 7 days." }, "external_dataset_id": { "title": "Include an existing dataset by id into the output", "pattern": "^[a-zA-Z0-9-]+$", "minLength": 17, "maxLength": 17, "type": "string", "description": "If you want to include an existing dataset into the output, provide the dataset id here. The actor will look for the dataset and include its items if applicable" } } }, "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 } } }, "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 } } } } } } } } } }