{ "openapi": "3.0.1", "info": { "title": "Kununu Jobs Scraper", "description": "Find jobs listed on kununu with titles, employers, company ratings and work arrangements. Search the role or company you have in mind and review work arrangement and employer ratings when shown.", "version": "1.1", "x-build-id": "skmz1HxP4fxCZDzdk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/thescrappa~kununu-jobs-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-thescrappa-kununu-jobs-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/thescrappa~kununu-jobs-scraper/runs": { "post": { "operationId": "runs-sync-thescrappa-kununu-jobs-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/thescrappa~kununu-jobs-scraper/run-sync": { "post": { "operationId": "run-sync-thescrappa-kununu-jobs-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": { "query": { "title": "Job Search Query", "maxLength": 120, "type": "string", "description": "Job title or keyword, for example Software Engineer, Product Manager, Pflegefachkraft, or Sales." }, "location": { "title": "Location", "maxLength": 120, "type": "string", "description": "City or location name. Pass a plain city name such as Berlin, Munich, Vienna, Zurich, or Hamburg." }, "country": { "title": "Country", "enum": [ "de", "at", "ch" ], "type": "string", "description": "Kununu country market.", "default": "de" }, "page": { "title": "Page", "minimum": 1, "maximum": 100, "type": "integer", "description": "First Kununu result page to fetch. Kununu returns about 30 results per page.", "default": 1 }, "max_pages": { "title": "Max Pages", "minimum": 1, "maximum": 10, "type": "integer", "description": "Number of consecutive Kununu result pages to fetch in one run.", "default": 1 }, "radius": { "title": "Radius", "minimum": 10, "maximum": 200, "type": "integer", "description": "Search radius in kilometers around the selected location. Allowed values: 10, 20, 30, 50, 100, or 200." }, "sort": { "title": "Sort", "enum": [ "", "newest", "kununuScore" ], "type": "string", "description": "Sort by newest listings or by Kununu company score. Leave empty for Kununu relevance order.", "default": "" }, "workplace": { "title": "Workplace Model", "type": "array", "description": "Filter jobs by remote, hybrid, or on-site workplace model.", "items": { "type": "string", "enum": [ "FULL_REMOTE", "PARTLY_REMOTE", "NON_REMOTE" ], "enumTitles": [ "Remote", "Hybrid", "On-site" ] } }, "employment_types": { "title": "Employment Types", "type": "array", "description": "Filter by employment type.", "items": { "type": "string", "enum": [ "FULL_TIME", "PART_TIME", "INTERN", "TEMPORARY", "CONTRACTOR", "SEASONAL", "VOLUNTARY" ], "enumTitles": [ "Full-time", "Part-time", "Internship", "Temporary", "Contractor", "Seasonal", "Voluntary" ] } }, "career_level": { "title": "Career Level", "type": "array", "description": "Filter by career level. Values follow Kununu's career-level IDs.", "items": { "type": "string", "enum": [ "1", "2", "3", "4", "5", "6", "99" ], "enumTitles": [ "Student or intern", "Entry-level", "Experienced", "Manager", "Director", "Executive", "Apprentice" ] } }, "kununu_score": { "title": "Kununu Score", "type": "array", "description": "Filter by company score range.", "items": { "type": "string", "enum": [ "4-5", "3-4", "2-3", "1-2" ], "enumTitles": [ "4 to 5", "3 to 4", "2 to 3", "1 to 2" ] } }, "industry": { "title": "Industry IDs", "maxItems": 10, "type": "array", "description": "Kununu industry IDs from 1 to 44.", "items": { "type": "integer", "minimum": 1, "maximum": 44 } }, "discipline": { "title": "Discipline IDs", "maxItems": 10, "type": "array", "description": "Kununu discipline or field-of-activity IDs from 1001 to 1022.", "items": { "type": "integer", "minimum": 1001, "maximum": 1022 } }, "benefits": { "title": "Benefits", "type": "array", "description": "Filter jobs by employer benefits.", "items": { "type": "string", "enum": [ "flexWorkingHours", "pensionPlan", "coaching", "mobilePhone", "internet", "healthProgram", "reachability", "events", "discounts", "parking", "car", "meals", "dogs", "daycare", "cantine", "stockOptions", "doctor", "accessibility", "material", "clothes", "transportation" ], "enumTitles": [ "Flexible working hours", "Pension plan", "Coaching", "Mobile phone", "Internet", "Health program", "Good reachability", "Employee events", "Employee discounts", "Parking", "Company car", "Meals", "Dogs allowed", "Daycare", "Canteen", "Stock options", "Company doctor", "Accessibility", "Work equipment", "Work clothes", "Transportation" ] } }, "is_top_company": { "title": "Top Company Only", "type": "boolean", "description": "Only return employers with Kununu Top Company status.", "default": false }, "include_raw_job": { "title": "Include Raw Job", "type": "boolean", "description": "Move unmapped Scrappa job fields into raw_job instead of spreading them at the top level. Mapped fields remain at the top level.", "default": false } } }, "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 } } } } } } } } } }