# Changelog of Apple App Store Scraper - Rankings, Reviews & Apps (`haketa/app-store-scraper`) Actor

- **URL**: https://apify.com/haketa/app-store-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/haketa/app-store-scraper.md

## Changelog

### 1.1.0 — 2026-11-01

- **Verified a fresh 501-review run** across 5 major apps (WhatsApp, Instagram, Facebook, Spotify via bundle ID, Gmail): **0% duplicate rate** on `reviewId`, and 100% coverage on every review field — `reviewId`, `userName`, `userUrl`, `score`, `title`, `text`, `version`, `url`, `updated`. Newest reviews were dated the day before the run, confirming live freshness.
- **Verified a fresh US Top Free rankings run** (`fullDetail: true`): 100 apps, contiguous ranks `1…100`, **0 duplicates**, in ~5 seconds. Core fields (`appId`, `bundleId`, `title`, `url`, `developer`, `score`, `reviews`, `price`, `genre`, `currency`, `contentRating`, `languages`, `description`, `version`) all at **100%**; `developerWebsite` ~90% and `ipadScreenshots` ~73% (both correctly data-dependent).
- Confirmed deep review pagination works (page-by-page, 50/page) and that the `maxItems` cap and per-app concurrency terminate runs cleanly.
- **README refreshed to gold standard**, grounded in the fresh output: corrected the ranked-app and review JSON examples to match real records exactly (including the `?uo=4` URL suffix, string `size` in bytes, and timezone-offset review dates), clarified the `appId` vs `bundleId` behavior for reviews, documented honest field-coverage numbers, and tightened the Pagination & scale and FAQ sections.
- Clarified realistic feed ceilings (~100–200 apps per chart/search; up to ~500 reviews per app per country, with most apps exposing a few hundred) so expectations match Apple's public feeds.
- No code changes required — the scraper is healthy: iTunes Search / Lookup + RSS feeds over HTTP/JSON, no login, direct connection by default with optional Apify proxy rotation.

### 1.0.0 — 2026-06-05

- Initial release: Apple App Store scraper with four modes — **top-chart rankings** (Top Free / Paid / Grossing / New, iPhone & iPad) by category and country, **app reviews & ratings**, **full app details** (with star-rating histogram), and **keyword search**.
- App references accepted as numeric App ID, bundle ID or App Store URL; 47 country storefronts; JSON/CSV/Excel/XML/API export.
