> **For coding agents and LLMs:** This is one Social Fetch marketing page (markdown export). For API orientation start with [`/llms.txt`](https://www.socialfetch.dev/llms.txt); for auth and crawl rules use [`/agents.txt`](https://www.socialfetch.dev/agents.txt); for every operation use [`/llms-endpoints.txt`](https://www.socialfetch.dev/llms-endpoints.txt).

## This page

- **On-site (HTML):** <https://www.socialfetch.dev/platforms/google-play/apps-appid-reviews>
- **Markdown (.mdx) URL:** <https://www.socialfetch.dev/platforms/google-play/apps-appid-reviews.mdx>

---

# 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}/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.

## Request

- **Endpoint:** `GET /v1/google-play/apps/{appId}/reviews`
- **Credits:** 1 credit
Failed requests are free
- **Input:** by app id
- **Full reference:** [docs](https://www.socialfetch.dev/docs/api/v1/google-play/apps/appid/reviews/get)
- **Platform page:** [/platforms/google-play](https://www.socialfetch.dev/platforms/google-play)

## 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.
