Google Play Reviews API
Reviews of any Android app with star filters, helpful counts, app versions and developer replies.
GET /v1/google-play/apps/{appId}/reviews1 credit Failed requests are free
About this endpoint
GET /v1/google-play/apps/{appId}/reviews takes the package name, an optional country and language, a sort (recent, relevant or rating), a stars filter from 1 to 5 and a limit up to 150. Each review has its id, body, rating, postedAt, helpfulCount, the appVersion the reviewer used, the reviewer's display name and picture, and the developer's reply with its date when there is one.
Follow data.page.nextCursor while data.page.hasMore is true to read further back. Keep the same sort, stars, country and language on every page: a cursor belongs to the request it came from, and one passed with other filters is refused before any work. The language decides which reviews come back as well as their text, since Google Play groups reviews by language.
Price
From $1.35 per 1,000 requests
1 credit per request. Failed requests are free.
- Scale pack
- $1.64 / 1,000
- Growth pack
- $2.36 / 1,000
The lowest rate is on annual plans; packs are pay as you go.
Example request
Send your API key in the x-api-key header. New accounts get 100 free credits, no card needed.
Example response
A 200 response. Live responses have the same shape with current data.
Google Play Reviews API FAQ
How many reviews can I read?
Up to 150 a page, and as many pages as the app has. Pass data.page.nextCursor as cursor until data.page.hasMore is false.
How many credits does it cost?
Pricing is documented on the operation in the API registry (shown on this page). Confirm on every response with meta.creditsCharged: that field is the billing source of truth. Each paginated page is a separate billed request.
How do I read only one-star reviews?
Set stars=1. Combine it with sort=relevant for the store's own ranking or sort=recent for the newest first.
What if the app has no reviews?
You get data.lookupStatus found with an empty reviews list. If the app does not exist, lookupStatus is not_found.
Why did my cursor get refused?
A cursor only works with the app, country, language, sort and stars it was issued for. Start again without a cursor if you change any of them.
Other Google Play endpoints
- AppGET /v1/google-play/apps/{appId}
- DeveloperGET /v1/google-play/developers/{developerId}
- SearchGET /v1/google-play/apps/search
- Search suggestionsGET /v1/google-play/suggestions
- ChartsGET /v1/google-play/charts
- CategoriesGET /v1/google-play/categories
- StorefrontsGET /v1/google-play/storefronts
- LanguagesGET /v1/google-play/languages