# Changelog of Kununu Reviews Scraper (`radeance/kununu-reviews-scraper`) Actor

- **URL**: https://apify.com/radeance/kununu-reviews-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/radeance/kununu-reviews-scraper.md

#### Version 0.0.30 - Improvement Update

**Release Date:** 2026-09-03

##### Improvements and Fixes:

###### **Improvements added**

- Added a new `only_unique` parameter to get only unique reviews for each company. When set to `true`, the actor will filter out duplicate reviews based on their content, ensuring that only distinct reviews are included in the output. This helps to avoid redundancy due to the new review fencing mechanism implemented by Kununu.

###### **Issues fixed**

- General stability improvements

#### Version 0.0.29 - Improvement Update

**Release Date:** 2026-08-31

##### Improvements and Fixes:

###### **Improvements added**

- Added a new `sort_by` parameter to allow users to control the sorting order of the reviews. Users can now select between `newest`, `relevance`, `oldest`, `best`, and `worst` to customize the review output according to their preferences. Previously, the reviews were sorted by `relevance` as Kununu's default sorting order

###### **Issues fixed**

- General stability improvements

#### Version 0.0.28 - Hotfix Update

**Release Date:** 2026-08-01

##### Improvements and Fixes:

###### **Issues fixed**

- Resolved valid company slugs or URLs not being processed correctly due to recent changes to the source data structure causing validation errors
- General stability improvements

#### Version 0.0.27 - Improvement Update

**Release Date:** 2026-05-30

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Improved & restructured documentation including new field reference table for better understanding of the output data structure and easier integration into user workflows

#### Version 0.0.25 - Hotfix Update

**Release Date:** 2026-04-14

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Added deduplication of provided company slugs during the URL validation process to prevent processing the same company multiple times in a single run, improving efficiency and avoiding redundant data retrieval
- Added a new `external_dataset_id` parameter to allow users to include existing datasets into the output by providing the dataset id. The actor will look for the dataset and include its items if applicable, enabling seamless data integration and enrichment from previous runs or related datasets

#### Version 0.0.24 - Hotfix Update

**Release Date:** 2026-04-13

##### Improvements and Fixes:

###### **Issues fixed**

- Resolved validation issues on Kununu company pages without data
- Improved error handling to better manage unexpected issues during scraping

###### **Improvements added**

#### Version 0.0.24 - Hotfix Update

**Release Date:** 2026-04-08

##### Improvements and Fixes:

###### **Issues fixed**

- Improved stability and performance of the scraper to handle recent changes on Kununu's website structure and bot protection mechanisms
- Improved error handling to better manage unexpected issues during scraping
- Improved logs for better debugging and monitoring of scraping activities

###### **Improvements added**

-

#### Version 0.0.23 - Hotfix Update

**Release Date:** 2026-04-07

##### Improvements and Fixes:

###### **Issues fixed**

- Fixed a critical issue where the scraper wouldnt retrieve any data due to major changes to bot protection mechanisms on Kununu
- General stability improvements

###### **Improvements added**

-

#### Version 0.0.22 - Hotfix Update

**Release Date:** 2026-02-13

##### Improvements and Fixes:

###### **Issues fixed**

- Fixed a critical issue where the scraper was crashing due to changes to Apifys schema handling
- General stability improvements

###### **Improvements added**

-

#### Version 0.0.21 - Improvement Update

**Release Date:** 2026-02-13

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Improved output table views with new fields and better organization for easier data analysis and integration

#### Version 0.0.20 - Improvement Update

**Release Date:** 2026-01-30

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Added `data_captured_at` field to the output model to indicate the exact timestamp when the data was captured
- Added historical overall score data for the last 5 years `company_overall_score_history` including year, score, rounded score, and total reviews
- Added `is_top_company` and `top_company_years` to indicate if a company has been recognized as a top company in the current year and the historical respective years
- Added `deleted_reviews_count_last_24_months` to provide insights into the number of reviews deleted or unpublished in the last 24 months
- Added `company_overall_score_trend_last_24_months` and `company_overall_score_trend_older_than_24_months` to show score trends over different time periods
- Added response time metrics including `reviews_response_time_days`, `total_reviews_response_count`, `total_employer_reviews_response_count`, `total_apprenticeship_reviews_response_count`, `total_application_reviews_response_count` and `total_reviews_responded_percentage` for better understanding of company responsiveness to reviews

#### Version 0.0.18 - Maintenance Update

**Release Date:** 2025-10-27

##### Improvements and Fixes:

###### **Issues fixed**

- Resolved issues with data validation causing run crashes

###### **Improvements added**

-

#### Version 0.0.17 - Maintenance Update

**Release Date:** 2025-10-14

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Improved proccessing performance
- Revamped Documentation to provide better readability and clarity

#### Version 0.0.16 - Improvement Update

**Release Date:** 2025-09-29

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Readded `Company` and `Salary` Output views for better data organization

#### Version 0.0.15 - Improvement Update

**Release Date:** 2025-09-05

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Improved proccessing performance
- Added usage limits for free users to 3 companies per run and 25 runs per month
- Improved logs and general error handling

#### Version 0.0.14 - Maintenance Update

**Release Date:** 2025-08-17

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Improved logs and general error handling

#### Version 0.0.12 - Maintenance Update

**Release Date:** 2025-08-16

##### Improvements and Fixes:

###### **Issues fixed**

- General stability improvements

###### **Improvements added**

- Improved logs and general error handling

#### Version 0.0.11 - Issue Resolving Update

**Release Date:** 2025-08-15

##### ✅ Improvements and Fixes

###### **Issues fixed**

- Fixed an data validation issue that caused the scraper to fail on certain pages

###### **Improvements added**

- Improved general stability of our services

#### Version 0.0.10 - Improvement Update

**Release Date:** 2025-08-15

##### ✅ Improvements and Fixes

###### **Issues fixed**

-

###### **Improvements added**

- Increased the maximum value for the `max_reviews` parameter to 50,000, allowing users to scrape a significantly larger number of reviews per company
- Improved general stability of our services
- Updated Readme

#### Version 0.0.9 - Maintenance Update

**Release Date:** 2025-08-07

##### ✅ Improvements and Fixes

###### **Issues fixed**

-

###### **Improvements added**

- Improved general stability of our services
- Updated Readme

#### Version 0.0.8 - Stability Update

**Release Date:** 2025-07-14

##### ✅ Improvements and Fixes

###### **Issues fixed**

-

###### **Improvements added**

- Improved general stability of our services
- Updated Readme

#### Version 0.0.7 - Issue Resolving Update

**Release Date:** 2025-07-07

##### ✅ Improvements and Fixes

###### **Issues fixed**

- We fixed a major issue where users experience a crash on response timeouts after max\_retries

###### **Improvements added**

- We added direct search support, users are now able to search for companies by name like `Dr. Oetker GmbH`
- We now support a lot of new URLs formats like
  - `https://www.kununu.com/sap`
  - `https://kununu.com/mercedes-benz-group/kommentare`
  - `https://kununu.com/bmw`
- We added a new `include_reviews` parameter to control reviews data inclusion, users are now able to scrape company data without reviews
- We added a new `max_salaries` parameter to control the maximum number of salaries to scrape
- Improved Documentation adding a supported urls and a usage limits section
- Improved logs readability

#### Version 0.0.6 - Major Improvement Update

**Release Date:** 2025-06-20

##### ✅ Improvements and Fixes

###### **Issues fixed**

- Resolved some crashes due to data validation issues

###### **Improvements added**

- Removed 'last\_x\_days' params as it is completly deprecated, use 'review\_posted' instead
- General stability improvements

#### Version 0.0.5 - Major Improvement Update

**Release Date:** 2025-06-19

##### ✅ Improvements and Fixes

###### **Issues fixed**

###### **Improvements added**

- Introduced a new multiple\_reviews field for more granular review insights
- Added 10+ new metadata fields including: company website, verified status, paying for top company badge, industry average review score, compensation statisfaction
- Integrated company salary data and salary review details
- Added a new include\_salaries parameter to control salary data inclusion
- Enhanced the output format with a cleaner structure and a brand new Salaries view
- Improved logs

#### Version 0.0.3 - Issue Resolving Update

**Release Date:** 2025-05-08

##### ✅ Improvements and Fixes

###### **Issues fixed**

- Fixed an issue where the max\_reviews parameter was incorrectly capped at 100, ignoring user-defined values

###### **Improvements added**

- Increased the maximum value for the last\_x\_days parameter to 3,650, allowing users to query data from up to 10 years ago
- Improved logs

#### Version 0.0 - Initial Release

**Release Date:** 2025-04-25

##### Features:

- **🗃️ Full Kununu Company Review Scraping**
  Scrapes comprehensive review data from public Kununu company pages <br> Extracts high-quality data such as: - Company UUID + Slug - Company Overall Score - Employees Overall Score - Employees Overall Score (Rounded) - Candidates Overall Score - Candidates Overall Score (Rounded) - Oldest Employee Review Date - Newest Employee Review Date - Oldest Candidate Review Date - Newest Candidate Review Date - Reviews & Responses

<br>

- **⬆ Data Output:**
  - Outputs dataset as JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML for easy integration and analysis
  - Provides a clean and structured data output for further processing or direct use <br>
- **🛠️ Error Handling and Logging:**
  - Comprehensive error handling to manage site-specific issues and changes
  - Detailed logging to assist in debugging and tracking scraping activities

##### Improvements and Fixes:

- Initial release with all core features and functionalities fully tested
- Resolved initial bugs

##### Notes:

- Users are encouraged to provide feedback for further improvements
- Future updates will focus on continuing to improve and enhance searching capabilities

For any issues or suggestions, please open up an issue on the platform

***

This changelog entry documents the initial release of the Kununu Reviews Scraper actor, detailing its core features, functionalities, and initial bug fixes
