App stores

Google Play Reviews API

Google Play Reviews API returning user reviews, ratings, and dates for any app, with country and language targeting, sorting, and pagination.

Try in the request builder API reference Connect with MCP

Make a request

Use your existing PrismCrawl API key and credit balance. A completed request consumes one credit, including recognized empty or unavailable results and source changes found during a valid continuation. Validation and operational errors remain uncharged. Each completed continuation request is billed separately.

POST /v1/google/play/reviews

curl 'https://api.prismcrawl.com/v1/google/play/reviews' \
  --request POST \
  --header 'content-type: application/json' \
  --header 'x-api-key: <PRISMCRAWL_API_KEY>' \
  --data '{
  "country": "us",
  "id": "com.google.android.apps.maps",
  "language": "en"
}'

Supported parameters

Parameter	Usage
`id`Required	The app's package ID from Google Play search results or the id parameter in its store URL, such as com.google.android.youtube. App and company names are not IDs. Use 1–250 letters, digits, dots, underscores, or hyphens.
`country`	Two-letter country or storefront code, such as us or gb.
`language`	Provider-supported language code, such as en.
`limit`	Maximum number of items to return. The provider may return fewer.
`next_page_token`	Copy the opaque next_page_token from the previous response using the same account, search parameters, device, and result limit. Tokens expire after one hour; restart pagination if rejected or expired.
`sort_by`	The provider's supported sort order. newest, relevant, rating
`device`	Device presentation for the source request. desktop, mobile, tablet
`html`	Return the encoded original response rather than parsed JSON.
`zero_trace`	Do not archive source or parsed response artifacts.
`rating`	Return reviews with exactly this star rating.
`platform`	Filter native reviews by device form factor. phone, tablet, watch, chromebook, tv, car
`category`	A category identifier supported by this operation. apps, books, audiobooks, movies, tv

Structured results

Read items from data.content.results. The response also includes the search metadata, pagination state, and any extracted SERP features. Optional fields appear when supplied by the provider.

authorauthor_imageauthor_urldatedate_textdeveloper_responsehelpful_votesidis_excerptlanguagenamephotospositionpublished_atrankratingrating_maxsourcetextthumbnailtitletypeupdated_aturlversionvote_count

Continue with data.content.next_page_token when has_next_page is true. Omit page when using a token and keep the other request parameters unchanged, including the query or ID, country, language, device, result limit, and sort order. Stop when no token is returned. Tokens belong to the same account and expire after one hour. Restart pagination if a token is expired or rejected, including tokens issued before authenticated tokens were introduced. If the source inventory changes after a valid continuation is fetched, a completed HTTP 200 response costs one credit and marks pagination_limited: true with pagination_reason: stale_cursor. Keep any returned results and restart pagination; no continuation token is returned.

SDKs and guides

The official SDKs cover this endpoint with typed parameters, automatic retries, and pagination helpers.

Python SDK: pip install prismcrawl
Node.js SDK: npm install prismcrawl