{
  "openapi": "3.0.1",
  "info": {
    "title": "kununu Reviews Scraper - Employer Reviews, Ratings & Salaries",
    "description": "Scrape kununu employer reviews and company profiles for Germany, Austria and Switzerland: scores, 13 category ratings, pros/cons, employer responses, applicant interview reviews, salaries, benefits and culture. Filters, keyword search in reviews, monitor mode. No login.",
    "version": "0.1",
    "x-build-id": "41J4SxAf0lEb7uKkN"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~kununu-reviews-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-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/scrapersdelight~kununu-reviews-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-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/scrapersdelight~kununu-reviews-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-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",
        "properties": {
          "startUrls": {
            "title": "🔗 Company URLs or slugs",
            "type": "array",
            "description": "kununu company URLs (any tab), `de/slug` or a bare slug, e.g. \"https://www.kununu.com/de/sap\", \"at/boschoesterreich\", \"psi-software\". DE, AT and CH can be mixed. A kununu search URL works too.",
            "items": {
              "type": "string"
            }
          },
          "companyNames": {
            "title": "🏢 Company names",
            "type": "array",
            "description": "Plain employer names, resolved with kununu's own search to the best-matching profile, e.g. \"Bosch\", \"SAP\", \"Deutsche Bahn\". Names without a match are listed in RUN_SUMMARY and never billed.",
            "items": {
              "type": "string"
            }
          },
          "searchQueries": {
            "title": "🔎 Search the employer directory",
            "type": "array",
            "description": "Keywords for kununu's employer search, e.g. \"software\", \"Krankenhaus\", \"Logistik Hamburg\". Each match becomes a company card (and its reviews, if Reviews per company > 0).",
            "items": {
              "type": "string"
            }
          },
          "countryCode": {
            "title": "🌍 Country",
            "enum": [
              "de",
              "at",
              "ch"
            ],
            "type": "string",
            "description": "kununu country for searches, names and bare slugs. Pasted URLs keep their own country.",
            "default": "de"
          },
          "reviewTypes": {
            "title": "📝 Review types",
            "type": "array",
            "description": "Employee reviews (includes apprentice, intern, student and manager reviews) and/or applicant reviews (interview experience, result, questions).",
            "items": {
              "type": "string",
              "enum": [
                "employees",
                "candidates"
              ],
              "enumTitles": [
                "Employee reviews",
                "Applicant (interview) reviews"
              ]
            },
            "default": [
              "employees"
            ]
          },
          "reviewSort": {
            "title": "↕️ Sort reviews",
            "enum": [
              "newest",
              "relevance",
              "oldest",
              "best",
              "worst"
            ],
            "type": "string",
            "description": "Order kununu returns reviews in. Newest is best for monitoring.",
            "default": "newest"
          },
          "reviewScores": {
            "title": "⭐ Rating buckets",
            "type": "array",
            "description": "Only reviews in these kununu score buckets. Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "excellent",
                "good",
                "satisfactory",
                "subpar"
              ],
              "enumTitles": [
                "Excellent (4-5)",
                "Good (3-4)",
                "Satisfactory (2-3)",
                "Subpar (1-2)"
              ]
            }
          },
          "reviewPositions": {
            "title": "👤 Reviewer position",
            "type": "array",
            "description": "Only reviews written by these positions (employee reviews only). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "employee",
                "manager",
                "apprentice",
                "student",
                "intern",
                "contractor",
                "freelancer"
              ],
              "enumTitles": [
                "Employee",
                "Manager",
                "Apprentice",
                "Student",
                "Intern",
                "Contractor",
                "Freelancer"
              ]
            }
          },
          "reviewDepartments": {
            "title": "🏷️ Department",
            "type": "array",
            "description": "Only reviews from these departments (employee reviews only). Empty = all.",
            "items": {
              "type": "string",
              "enum": [
                "administration",
                "communication",
                "controlling",
                "design",
                "it",
                "legal",
                "logistic",
                "management",
                "operations",
                "procurement",
                "product",
                "recruiting",
                "research",
                "sales"
              ],
              "enumTitles": [
                "Administration",
                "Communication",
                "Controlling",
                "Design",
                "IT",
                "Legal",
                "Logistics",
                "Management",
                "Operations",
                "Procurement",
                "Product",
                "Recruiting",
                "Research",
                "Sales"
              ]
            }
          },
          "jobStatus": {
            "title": "🔄 Current or former",
            "enum": [
              "any",
              "current",
              "former"
            ],
            "type": "string",
            "description": "Only reviews by current or by former employees.",
            "default": "any"
          },
          "recommendation": {
            "title": "👍 Recommends the employer",
            "enum": [
              "any",
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Only reviews that do / do not recommend the employer.",
            "default": "any"
          },
          "employerResponse": {
            "title": "💬 Employer response",
            "enum": [
              "any",
              "yes",
              "no"
            ],
            "type": "string",
            "description": "Only reviews the employer answered (or did not answer).",
            "default": "any"
          },
          "reviewDateWindow": {
            "title": "📅 Published within",
            "enum": [
              "any",
              "30days",
              "6months",
              "12months",
              "24months"
            ],
            "type": "string",
            "description": "kununu's own date window. Pairs well with a schedule.",
            "default": "any"
          },
          "reviewYears": {
            "title": "🗓️ Years",
            "type": "array",
            "description": "Only reviews written in these years, e.g. \"2025\", \"2026\". Empty = all years.",
            "items": {
              "type": "string"
            }
          },
          "reviewKeyword": {
            "title": "🔤 Keyword in review text",
            "type": "string",
            "description": "kununu's own full-text search inside reviews, e.g. \"homeoffice\", \"Gehalt\", \"Führung\". Only matching reviews are returned."
          },
          "searchIndustry": {
            "title": "🏭 Industry (directory search)",
            "enum": [
              "1",
              "2",
              "3",
              "4",
              "5",
              "6",
              "7",
              "8",
              "9",
              "10",
              "11",
              "12",
              "13",
              "14",
              "15",
              "16",
              "17",
              "18",
              "19",
              "20",
              "21",
              "22",
              "23",
              "24",
              "25",
              "26",
              "27",
              "28",
              "29",
              "30",
              "31",
              "32",
              "33",
              "34",
              "35",
              "36",
              "37",
              "38",
              "39",
              "40",
              "41",
              "42",
              "43",
              "44"
            ],
            "type": "string",
            "description": "Narrow Search the employer directory to one kununu industry. Labels as kununu shows them."
          },
          "reviewsNewerThan": {
            "title": "⏱️ Reviews newer than",
            "type": "string",
            "description": "Keep reviews published on or after this date: \"2026-01-01\" or relative \"30 days\", \"6 months\". kununu's date window is used when it fits."
          },
          "minReviewScore": {
            "title": "Minimum review score",
            "minimum": 1,
            "maximum": 5,
            "type": "number",
            "description": "Keep reviews scored at least this (1.0-5.0), e.g. 4.5."
          },
          "maxReviewScore": {
            "title": "Maximum review score",
            "minimum": 1,
            "maximum": 5,
            "type": "number",
            "description": "Keep reviews scored at most this (1.0-5.0), e.g. 2 for complaints only."
          },
          "onlyReviewsWithText": {
            "title": "Only reviews with written text",
            "type": "boolean",
            "description": "Skip reviews that carry only star ratings (no pros, cons, suggestions or category comments).",
            "default": false
          },
          "minCompanyScore": {
            "title": "Minimum company score",
            "minimum": 1,
            "maximum": 5,
            "type": "number",
            "description": "Skip companies rated below this kununu score (1.0-5.0). Applies to company rows and search cards."
          },
          "minCompanyReviews": {
            "title": "Minimum company review count",
            "minimum": 0,
            "maximum": 1000000,
            "type": "integer",
            "description": "Skip companies with fewer reviews than this, e.g. 50."
          },
          "maxReviewsPerCompany": {
            "title": "📝 Reviews per company",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "How many reviews to deliver per company (all review types together). 0 = company rows only. kununu shows signed-out visitors 10 reviews per page of a big profile; the actor reads kununu's own filter views to go further.",
            "default": 20
          },
          "includeCompanyRows": {
            "title": "🏢 Company profile rows",
            "type": "boolean",
            "description": "One full profile row per company: scores, review counts, recommendation rate, category scores, benefits, awards, culture, contact data.",
            "default": true
          },
          "searchDetailLevel": {
            "title": "Search results as",
            "enum": [
              "cards",
              "full"
            ],
            "type": "string",
            "description": "Cards: the search card only (name, score, review count, industry, city), no extra request. Full: the complete profile row for every match.",
            "default": "cards"
          },
          "includeSalaries": {
            "title": "💶 Full salary table",
            "type": "boolean",
            "description": "Add every published salary range per job title (min, max, median, average, number of reports) plus pay vs industry. One extra request per 10 job titles.",
            "default": false
          },
          "maxSalariesPerCompany": {
            "title": "Salary job titles per company",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Cap on salary rows embedded per company.",
            "default": 20
          },
          "includeCulture": {
            "title": "🧭 Culture comments",
            "type": "boolean",
            "description": "Add kununu's culture page: overall culture rating vs industry, company statements and culture comments. The Kulturkompass scores are on every company row anyway.",
            "default": false
          },
          "includeRichContent": {
            "title": "📄 Employer branding content",
            "type": "boolean",
            "description": "Add the employer's own profile texts as plain text (what is special, who we are, who we look for, benefits, advice for applicants), image and video galleries and employee Q&A.",
            "default": false
          },
          "includeAiSummary": {
            "title": "🤖 kununu AI review summary",
            "type": "boolean",
            "description": "Add kununu's AI summary of the reviews (overall + per category) when kununu publishes one (large profiles).",
            "default": true
          },
          "includeContactData": {
            "title": "📧 Contact data",
            "type": "boolean",
            "description": "Emails and phone numbers the employer published in its own profile texts and addresses.",
            "default": true
          },
          "monitorMode": {
            "title": "🔁 Only new reviews (monitor)",
            "type": "boolean",
            "description": "Deliver only reviews not delivered by earlier runs with the same filters; company rows only when score or review count changed. Pairs with a daily schedule.",
            "default": false
          },
          "monitorStoreName": {
            "title": "Monitor memory name",
            "type": "string",
            "description": "Named key-value store that remembers delivered reviews. Use one name per monitoring job.",
            "default": "kununu-reviews-monitor"
          },
          "maxResults": {
            "title": "📦 Max rows",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Hard cap on rows saved (company rows, search cards and reviews together). 0 = no cap. Your main cost control.",
            "default": 100
          },
          "maxCompaniesPerSearch": {
            "title": "Companies per search",
            "minimum": 1,
            "maximum": 5000,
            "type": "integer",
            "description": "How many employers to take from each directory search (kununu returns 12 per page).",
            "default": 20
          },
          "compact": {
            "title": "Compact rows",
            "type": "boolean",
            "description": "Core fields only - smaller rows for AI agents, MCP and spreadsheets.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Requests go direct first. When kununu refuses an IP, the run continues through an Apify datacenter proxy if your account has one, then through this proxy (Apify RESIDENTIAL, Germany, by default). Your own proxy URLs are used from the first request. Off = direct only.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ],
              "apifyProxyCountry": "DE"
            }
          },
          "maxConcurrency": {
            "title": "Parallel requests",
            "minimum": 1,
            "maximum": 16,
            "type": "integer",
            "description": "Requests in flight at once.",
            "default": 4
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}