# Changelog of Google Play Store Scraper (`automation-lab/google-play-scraper`) Actor

- **URL**: https://apify.com/automation-lab/google-play-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/automation-lab/google-play-scraper.md

## Changelog

This changelog highlights releases that materially changed Google Play Store Scraper for users. Dates use UTC; small internal refactors and routine maintenance are intentionally omitted.

### 2026-09-21

*Reliability*

- Default and empty search inputs now use the documented `whatsapp` example instead of terminating before producing results.

### 2026-09-20

*Reliability*

- Search inputs requesting more than the upstream-supported 250 apps now return useful results instead of finishing successfully with an empty dataset.
- Search, app-details, and review runs now fail clearly when every upstream request fails, while genuine empty results and partially successful batches remain valid.
- Review star filters now return only the requested rating, and valid sparse Top Paid charts return an honest empty dataset instead of a parser failure.

### 2026-09-14

*Reliability*

- App details inputs that contain search terms but no app IDs now run as a search instead of failing; valid details, reviews, Top Charts, and search inputs are unchanged.
- Input labels now make the mode-specific App ID and search-term requirements clearer.

### 2026-08-31

*Features*

- Added Top Charts discovery for ranked Top Free, Top Paid, and Top Grossing apps by Google Play category, country, and language.
- Ranked app records now include `chartRank`, `chartCollection`, and `chartCategory` alongside the existing app metadata.

### 2026-06-19

*Changes*

- Refreshed Store SEO copy for Google Play app, rating, review, install, screenshot, and developer-data use cases.

### 2026-05-22

*Reliability*

- Restored Google Play search results when the upstream search library returns empty responses.

### 2026-05-14

*Reliability*

- The Actor now respects Apify maximum charge per run and stops cleanly when the pay-per-event cap is reached.

### 2026-03-05

*Features*

- Initial release for scraping Google Play app details, search results, ratings, reviews, installs, screenshots, pricing, and developer data.
