Google Play Reviews API: App Reviews by Package Name and Language

Fetch Google Play user reviews for any Android app and get them as clean, flat rows: star score, review text, thumbs-up count, app version, date, and the developer's reply when there is one, together with the app title and a direct review URL. Give the Actor one or more package names or Play Store URLs, a language and a country, pick the sort order (newest, rating or helpfulness) and how many reviews to read per app, optionally filter by score, and it reads the public Play Store pages through the open-source google-play-scraper library. One free summary row per app adds the current average score, rating and review counts, installs, version, last update and price. No browser, no login, no proxies, so it runs in seconds and works well as an MCP tool for AI agents and in scheduled automations.

Use cases

• Product and support teams: pull the newest 1- and 2-star reviews of your Android app every morning and route them to Slack or a ticket queue.
• Competitive analysis: compare scores, complaints and developer responsiveness for several competing apps in different countries and languages.
• Sentiment and topic analysis: build a dataset of recent reviews per app version to see which release introduced a problem.
• AI agents: answer "what are Android users saying about app X this week?" with one structured call.
• Localisation research: fetch reviews in de, ja or pt-BR to see how an app is received in a specific market.

Input

Field	Default	Meaning
apps	["com.spotify.music"]	Android package names or Play Store URLs containing ?id=<package>.
lang	en	Language code (hl), e.g. en, de, pt-BR.
country	us	Two-letter Play Store country (gl), e.g. us, gb, in.
sortBy	newest	newest, rating or helpfulness; decides which reviews come first when the run is capped.
maxReviewsPerApp	100	Reviews to read per app, 1 to 2000 (150 per request).
minRating	–	Keep only reviews with this score or higher (1 to 5).
maxRating	–	Keep only reviews with this score or lower (1 to 5).
includeAppMetadata	true	Add one free rowType: "app" summary row per app.
maxItems	500	Maximum charged review rows per run.

The default run returns the 100 newest English reviews of Spotify (com.spotify.music) from the US store plus one app row.

Output

Field	Meaning
id	Stable key: <appId>:<reviewId>, or <appId>:app for the summary row.
rowType	review (charged) or app (free summary row).
appId, appName	Package name and app title.
reviewId, userName, text	Google's review id, reviewer display name, review text (paragraph breaks preserved).
score	Stars 1 to 5 as a number.
thumbsUp	How many users marked the review as helpful.
version	App version the review was written for (may be null).
date	ISO 8601 UTC time the review was written or last edited.
replyText, replyDate	Developer's public reply and its time, or null.
url	Play Store URL of the review (...&reviewId=<id>).
lang, country	Language and store country the row was fetched with.
fetchedAt	ISO 8601 UTC fetch time.

App rows (rowType: "app") additionally carry developer, developerId, genre, score (average), ratingCount, reviewCount, installs, minInstalls, updatedAt, releasedAt, free, price, currency and contentRating.

{
  "id": "com.spotify.music:0dd86112-a978-4d4f-a7f3-79d1552ba045", "rowType": "review",
  "appId": "com.spotify.music", "appName": "Spotify: Music and Podcasts",
  "reviewId": "0dd86112-a978-4d4f-a7f3-79d1552ba045", "userName": "Sonia Lafontaine",
  "text": "The best", "score": 5, "thumbsUp": 0, "version": "9.0.60.614",
  "date": "2026-11-02T15:04:06.172Z", "replyText": null, "replyDate": null,
  "url": "https://play.google.com/store/apps/details?id=com.spotify.music&reviewId=0dd86112-a978-4d4f-a7f3-79d1552ba045",
  "lang": "en", "country": "us", "fetchedAt": "2026-11-03T15:00:00.000Z"
}

The run summary (apps processed, requests made, reviews seen, errors) is stored in the OUTPUT record of the default key-value store.

How it works and limits

• For each app the Actor loads the app details page once (title, URL and the free summary row) and then requests reviews from the Play Store's internal batchexecute endpoint in pages of 150, following the continuation token until maxReviewsPerApp, maxItems or the last page is reached. It uses the open-source google-play-scraper library, not a browser.
• This is unofficial access to public Play Store pages. Google does not document or guarantee the endpoint; if the page format changes, the run may return no reviews until the library is updated.
• Google may rate-limit or temporarily block clients that request too much. The Actor sends at most one request per second and retries transient errors (429, 5xx, network) three times with exponential back-off. Keep volumes modest: a few hundred reviews per app per run is safe; thousands of reviews across many apps may be throttled.
• Rating filters are applied after fetching, so a page is always read in full; filtered-out reviews are not charged.
• Reviews are returned in the requested language and store only; Google decides which reviews appear in a given lang/country combination. version is null when Google does not show it.
• An app that does not exist (404) is reported in the run summary and the run finishes with status partial.

Pricing

Pay per result: $0.50 per 1,000 rows (result event). Platform usage is billed separately by Apify. Removed/free rows are not charged.

A default run (one app, 100 reviews) takes a few seconds and two requests.

Legal

Not affiliated with Google LLC. Uses the public Google Play Store web pages only (through the open-source google-play-scraper library). Data licence/terms: https://play.google.com/intl/en_us/about/play-terms/ (reviews are user-generated content published by Google; use them in accordance with Google's terms and applicable law).

FAQ

Where do I find the package name? It is the id parameter in any Play Store URL, e.g. https://play.google.com/store/apps/details?id=com.spotify.music gives com.spotify.music. You can paste the whole URL into apps.

Can I get all reviews of an app? Up to 2,000 per app per run. For a complete history, run the Actor regularly with sortBy: "newest" and deduplicate on id.

How do I get only negative reviews? Set minRating: 1 and maxRating: 2. Pages are still read in full, but only matching reviews are returned and charged.

Why do I get fewer reviews than requested? Google shows a limited number of reviews per language and country, and stops paging when they run out. Try another lang or country, or a different sortBy.

What happens if Google blocks the request? The Actor retries with back-off; if it still fails, the app is listed in errors in the run summary and the run finishes with status partial or failed. Wait a while and run again with a smaller maxReviewsPerApp.