Google Play Reviews API

GET | POST /v1/google-play/reviews

参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。

请求

curl "https://gateway.apinoa.com/v1/google-play/reviews?id=com.strava&country=US&sort=newest&limit=10" \
  -H "x-api-key: $APINOA_API_KEY"

参数

参数	类型	说明
`country`	enum	The market, as an ISO 3166 country code. `US` `GB` `CA` `AU` `NZ` `IE` `DE` `FR` `IT` `ES` `NL` `BE` `AT` `CH` `SE` `NO` `DK` `FI` `PL` `PT` `CZ` `GR` `HU` `RO` `TR` `UA` `IL` `AE` `SA` `EG` `ZA` `NG` `KE` `IN` `PK` `ID` `MY` `SG` `TH` `VN` `PH` `JP` `KR` `TW` `HK` `MX` `BR` `AR` `CL` `CO` `PE`
`cursor`	string	The previous page's `cursor`. Pass it alone for the next page.
`device`	enum	Reviews written on this kind of device (default phone). `phone` `tablet` `watch` `chromebook` `tv` `car`
`id`	string	The app's Play id: its package name (`com.strava`).
`lang`	string	Interface language.
`limit`	integer 1–200	Results wanted (default 40, at most 200). More than one page is charged per page.
`rating`	integer 1–5	Only reviews with this many stars (1-5).
`sort`	enum	Review order. `relevant` `newest` `highest` `lowest`
`url`	string	The app's Play link, instead of `id`.

这些参数及所有响应类型也写在OpenAPI 文档中。

响应

在 data 中返回 AppReviewsPage。真实响应的节选：数组只保留前几项，长文本已截断。

{
  "success": true,
  "data": {
    "engine": "google-play",
    "appId": "com.strava",
    "sort": "newest",
    "country": "US",
    "page": {"index": 1, "size": 10},
    "reviews": [
      {
        "id": "525d1b9c-6ae9-4caf-9e64-b97d92a1ba7a",
        "author": "Ryan Oliver",
        "rating": 4,
        "body": "expensive",
        "date": "2026-10-29T00:57:18.000Z",
        "helpfulCount": 0,
        "images": [],
        "ext": {
          "authorAvatarUrl": "https://play-lh.googleusercontent.com/a/ACg8ocIWJhJWleii7ygul0I9hOi7_TsD8dZhdfuBs3IpQdXu-A4bMA=mo",
          "authorId": "115264893161167747303",
          "appVersion": "486.11",
          "device": "phone"
        }
      },
      {
        "id": "a0b644e0-5d0c-4edc-b5ed-7f01f622d7cb",
        "author": "Yashika maayra Choudhary",
        "rating": 4,
        "body": "subscription is the bad else all good 🙌",
        "date": "2026-10-29T00:50:16.000Z",
        "helpfulCount": 0,
        "images": [],
        "ext": {
          "authorAvatarUrl": "https://play-lh.googleusercontent.com/a/ACg8ocLNkxYDolwPkpUyDO5nkv64QeZ9s6fhP9yfMyOs3ucO59dos80=mo",
          "authorId": "113477972146124328942",
          "appVersion": "486.11",
          "device": "phone"
        }
      }
    ],
    "cursor": "WkN_1HrvmhecZNG2rrdbx5weIWYO79AO2I7NN6ZpjZalfvHANgMvhooKLP5ZJfnBwvHwOehzDglpq5jMbzxuZ2P1wcEgwFWOR94mpo9l5a8_-DP_Rg-LvXESLvaVVWYtzuSB9UAkwl4G24l_vIG97vngjgIf2oNM…",
    "fetchedAt": "2026-10-30T00:57:31.869Z"
  }
}

错误

状态	代码	含义
400	`INVALID_CURSOR`	该 `cursor` 不是本操作返回的。请不带它重新开始。
400	`INVALID_PARAMS`	参数缺失、未知、超出范围，或该引擎不接受。消息中会指出是哪一个。
401	`UNAUTHORIZED`	缺少 `x-api-key` 请求头，或密钥已吊销或未知。
402	`INSUFFICIENT_BALANCE`	余额不足以支付本次调用。请在控制台充值。
404	`NOT_FOUND`	该商店的此市场中没有这个应用。
429	`MARKETPLACE_SATURATED`	并发调用过多。请等待 `Retry-After` 秒后重试。
502	`UPSTREAM_ERROR`	引擎返回了无法使用的内容。请退避后重试。
503	`SERVICE_UNAVAILABLE`	临时故障。请退避后重试。

全部错误代码见 Errors。失败的调用不计费。

价格

价格每次调用 $0.0012。标价；单日调用超过 1,000 次后单价下调。

说明

传入应用的包名或 Play 链接（url）。rating 只保留一个星级，device 选择撰写评论所用的设备类型。

Reviews

请求

参数

响应

错误

价格

说明

本页内容