// HELP / GOOGLE-PLAY-REVIEWS-API

Google Play Reviews API

ASORadar's Google Play Reviews API returns user reviews for any Android app as JSON over one REST call, billed per request. Same schema as the App Store Reviews API — one integration, both stores.

Quick start

Authenticate with your x-access-key header and pass the Google Play package name as app_id:

curl "https://api.asoradar.com/g1/reviews?app_id=com.whatsapp&country=us&lang=en" \
  -H "x-access-key: YOUR_ACCESS_KEY"

Create an account to get an access key and 100 free requests for testing.

Parameters

Parameter Type Default Description
app_id string — Required. Play package name (e.g. com.whatsapp).
country string us Two-letter country code for the catalogue.
lang string en Review language (Google Play reviews are language-scoped).
rating int — Keep only reviews with this star rating (1–5).
since / until datetime — ISO-8601 date window.
search string — Full-text filter over review text.
fresh bool false Bypass the cache and refetch from the store.
count int 200 Page size, up to 1000.

Unlike the App Store, Google Play scopes reviews by language, not just country. Pass lang= to target a specific review locale; combine country + lang to slice a market precisely.

Response shape

Cache-first, with the same envelope as the App Store endpoint:

{
  "items": [
    {
      "review_id": "gp:AOqpTOH...",
      "rating": 2,
      "body": "Notifications stopped working after the June update.",
      "author": "Priya K.",
      "version": "2.26.1",
      "lang": "en",
      "thumbs_up": 14,
      "created_at": "2026-06-22T11:02:00Z"
    }
  ],
  "total": 200,
  "cached": false,
  "fetched_at": "2026-06-24T22:05:00Z"
}

Common patterns

Post-release bug hunt — filter 1- and 2-star reviews for a keyword right after you ship:

curl "https://api.asoradar.com/g1/reviews?app_id=com.whatsapp&rating=1&search=notification" \
  -H "x-access-key: YOUR_ACCESS_KEY"

Multi-locale sentiment — loop over lang=en,es,pt,de for the same app_id to compare how a release lands across markets, then feed the text into your own sentiment pipeline (or use ASORadar's /g1/reviews/sentiment/{app_id} composite endpoint).

Watchlist sync — keep a list of competitor package names and run the same call across all of them on a schedule; pay only for the requests you make.

Why an API instead of google-play-scraper

Open-source scrapers like google-play-scraper work until Google changes the response format or rate-limits your IP — then you own the breakage. ASORadar runs and maintains the scraping fleet, normalizes both stores to one schema, and returns cache metadata so you control freshness vs cost.

Pricing

Pay-per-request from $0.001 per call, no subscription. Top up a balance, spend it on successful requests, watch consumption in the dashboard. See pricing.

FAQ

What is the Google Play app_id?

The package name from the Play URL — play.google.com/store/apps/details?id=com.whatsapp means app_id=com.whatsapp.

Why does lang matter on Google Play?

Google Play stores reviews per language. The same app shows different reviews under lang=en vs lang=es. Pass lang= to target the locale you care about.

Can I get both App Store and Google Play reviews from one integration?

Yes — /a1/reviews and /g1/reviews return the same JSON shape. Swap the prefix and the app_id format.

Is there a free tier?

100 free promo requests on signup, then pay-per-request from $0.001.