Google Play reviews

Request#

Authenticate with your API key in the x-api-key header (see Authentication).

Body#

JSON object. Unknown fields are rejected with 422.

• app_idstringrequiredmin length 3, max length 255, pattern ^[A-Za-z0-9_]+(\.[A-Za-z0-9_]+)+$

  Android package name, e.g. com.spotify.music: the id= value of a Play Store URL (play.google.com/store/apps/details?id=…) or app_id from POST /v1/google_play/search.

• sortstringdefault most_relevant

  Play's own review order. - most_relevant: Most relevant (Play's default order) - newest: Newest first - rating: Play's rating order (measured: 5-star reviews first)

  One ofmost_relevantnewestrating

• ratinginteger | nullmin 1, max 5

  Only reviews with this many stars (Play's own star filter). Omit for all.

• countintegerdefault 40min 1, max 200

  Reviews per page, 1..200. One page is one billed call whatever its size.

• page_tokenstring | nullmax length 2000

  next_page_token from the previous page of the same app_id, sort and rating. Omit for the first page.

• hlstringdefault en

  Language of the listing text (Play's hl), e.g. en, fr.

• glstringdefault us

  Storefront country (Play's gl): sets the price currency and the country's rating histogram.

  251 allowed values

  ad, ae, af, ag, ai, al, am, ao, aq, ar, as, at, au, aw, ax, az, ba, bb, bd, be, bf, bg, bh, bi, bj, bl, bm, bn, bo, bq, br, bs, bt, bv, bw, by, bz, ca, cc, cd, cf, cg, ch, ci, ck, cl, cm, cn, co, cr, cu, cv, cw, cx, cy, cz, de, dj, dk, dm, do, dz, ec, ee, eg, eh, er, es, et, fi, fj, fk, fm, fo, fr, ga, gb, gd, ge, gf, gg, gh, gi, gl, gm, gn, gp, gq, gr, gs, gt, gu, gw, gy, hk, hm, hn, hr, ht, hu, id, ie, il, im, in, io, iq, ir, is, it, je, jm, jo, jp, ke, kg, kh, ki, km, kn, kp, kr, kw, ky, kz, la, lb, lc, li, lk, lr, ls, lt, lu, lv, ly, ma, mc, md, me, mf, mg, mh, mk, ml, mm, mn, mo, mp, mq, mr, ms, mt, mu, mv, mw, mx, my, mz, na, nc, ne, nf, ng, ni, nl, no, np, nr, nu, nz, om, pa, pe, pf, pg, ph, pk, pl, pm, pn, pr, ps, pt, pw, py, qa, re, ro, rs, ru, rw, sa, sb, sc, sd, se, sg, sh, si, sj, sk, sl, sm, sn, so, sr, ss, st, sv, sx, sy, sz, tc, td, tf, tg, th, tj, tk, tl, tm, tn, to, tr, tt, tv, tw, tz, ua, ug, uk, um, us, uy, uz, va, vc, ve, vg, vi, vn, vu, wf, ws, xk, ye, yt, za, zm, zw

curl -X POST "https://api.scrapercompany.com/v1/google_play/reviews" \
  -H "x-api-key: $SCRAPERCOMPANY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "app_id": "com.spotify.music"
  }'

Response#

200 — One page of Google Play reviews with the next-page token. Metered responses carry x-credits-charged and x-credits-remaining headers (see credit headers).

{
  "search_parameters": {
    "engine": "google_play_reviews",
    "app_id": "com.spotify.music",
    "sort": "most_relevant",
    "count": 40,
    "hl": "en",
    "gl": "us"
  },
  "reviews": [
    {
      "review_id": "ad1d9be2-0959-4e98-8229-ee3ee4d9df0e",
      "author": {
        "name": "Reviewer A",
        "avatar": "https://play-lh.googleusercontent.com/a-/EXAMPLE-AVATAR"
      },
      "rating": 3,
      "text": "I love music, it's the only thing that keeps me focused…",
      "date": "2026-04-10T00:04:24Z",
      "thumbs_up": 58,
      "app_version": "9.1.36.1948",
      "developer_reply": {
        "text": "Hi. We'll pass this on to the ads team…",
        "date": "2026-04-10T11:17:33Z"
      }
    },
    {
      "review_id": "0bfaa654-1b56-41a0-8d27-dca2c9cb48cf",
      "author": {
        "name": "Reviewer B",
        "avatar": "https://play-lh.googleusercontent.com/a-/EXAMPLE-AVATAR"
      },
      "rating": 4,
      "text": "So they finally gave the option to disable smart shuffle…",
      "date": "2026-04-13T18:17:36Z",
      "thumbs_up": 67,
      "app_version": "9.1.36.1948"
    }
  ],
  "total": 2,
  "next_page_token": "CsEXAMPLE-next-page-token",
  "meta": {
    "source": "google_play",
    "wire_bytes": 30412,
    "elapsed_s": 0.31
  }
}

Errors#

Errors return a JSON body with a detail field. Failed requests are not charged. See Errors for the full list and retry advice.

Try it#

The quickest way: open this endpoint in Try it. It runs on your account with the example request filled in, shows the cost before you run, and shows the answer as a readable table next to the JSON and the code. Signed out? You sign in first and come straight back.

1. Export your key: export SCRAPERCOMPANY_API_KEY=sk_... (no key yet? request access).
2. Copy the cURL example above and run it in a terminal.
3. Or open the interactive playground on api.scrapercompany.com, paste your key and pick this endpoint.