Google Play Search API

GET | POST /v1/google-play/search

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

请求

curl "https://gateway.apinoa.com/v1/google-play/search?q=meditation&country=US" \
  -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.
`lang`	string	Interface language.
`limit`	integer 1–30	Results wanted (default 30, at most 30). More than one page is charged per page.
`q`	string	The query, search operators included.

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

响应

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

{
  "success": true,
  "data": {
    "engine": "google-play",
    "query": "meditation",
    "outcome": "results",
    "country": "US",
    "apps": [
      {
        "id": "com.spotlightsix.zentimerlite2",
        "name": "Insight Timer - Meditation App",
        "url": "https://play.google.com/store/apps/details?id=com.spotlightsix.zentimerlite2",
        "developer": {"name": "Insight Network Inc"},
        "icon": "https://play-lh.googleusercontent.com/H7MMtGtHuKqoT73wpfXXuqBgufaw3k03jUG58cqwJ1KITPU6nY8c1cvdAYCNcZY7xRwKwi-G3W6yltje3VbMnfY",
        "screenshots": [
          "https://play-lh.googleusercontent.com/jLCw4Aqw9zXkEqg4PTQY2qbhRBeitJCSdoSxFLGcWoRXHmlvIpooDGM0_e-qiC1bOHescBoXYc8MbSN7Rto2",
          "https://play-lh.googleusercontent.com/2F8LBZCzqXlm6d7VXOQfLxMmBTMODV7J8AzOxIYKTu5SUlp_OK1rCHW-jpq4whVMOn-74iv4OYJr6aWwFkSOOw"
        ],
        "description": "The world’s most popular wellness app.\n* Apps of the Year Winner - TIME magazine and Women's Health *\n* More time is spent on Insight Timer than on all other we…",
        "categories": ["Health & Fitness"],
        "rating": {"average": 4.6978846},
        "price": {"currency": "USD", "amount": 0},
        "inAppPurchases": true,
        "contentRating": "Everyone",
        "ext": {
          "inAppPriceRange": "$1.99 - $199.99 per item",
          "installs": "10,000,000+",
          "minInstalls": 10000000,
          "ratingText": "4.7",
          "headerImage": "https://play-lh.googleusercontent.com/HQk75PKY_glb6q9__cntlH06tyvIs-W2eRkC27BUokIzh4SmUPv-nZUNz30OLLf5S1JVZV7-A7bcR9gSlvnuJQ",
          "interactiveElements": "Users Interact, In-App Purchases",
          "descriptionHtml": "The world’s most popular wellness app.<br>* Apps of the Year Winner - TIME magazine and Women&#39;s Health *<br>* More time is spent on Insight Timer than on al…"
        },
        "rank": 1,
        "country": "US"
      },
      {
        "id": "meditofoundation.medito",
        "name": "Medito: Meditation & Sleep",
        "url": "https://play.google.com/store/apps/details?id=meditofoundation.medito",
        "developer": {"name": "Medito for Mindfulness, Meditation and Sleep"},
        "icon": "https://play-lh.googleusercontent.com/3GKenq_HBUYKA__-5oSy9wU0n3wWUYvaqcDg-tu3Di9MwsXkyPD9Gu3pdx9M8WJ8hK4bsfxKSdNTtckeKycywg",
        "screenshots": [
          "https://play-lh.googleusercontent.com/bQdN7TboplA9nw9bMVa-ahBtFh1tGG8Doa4gFO5AhdUAmfqmo2zsnbC4T0Sfq4ACsLQIMe2SUSkVrae9rXCK5w",
          "https://play-lh.googleusercontent.com/sNEmop6Cu57pqI55fH7xsK2_cPZWD60ad2srrdKm962kaabuUfOV12ZvTY7BOvEHZEjWooSb26qdJEzbSMZp6A"
        ],
        "description": "Free Meditation & Sleep Made Easy — Always Free.\n\nJoin 4 million+ people finding calm with Medito, your pocket‑size studio for guided meditation, mindfulness co…",
        "categories": ["Health & Fitness"],
        "rating": {"average": 4.780543},
        "price": {"currency": "USD", "amount": 0},
        "contentRating": "Everyone",
        "ext": {
          "installs": "1,000,000+",
          "minInstalls": 1000000,
          "ratingText": "4.8",
          "headerImage": "https://play-lh.googleusercontent.com/JbBFlKdHK2k9RtnL80bH81XGjwDnq2pgtI5uzLBB-zR7yZGCOJU3EydrCrouRlxrsWUobvY_1GXibfoAGZWj-BY",
          "contentRatingDescription": "Content is generally suitable for all ages. May contain minimal cartoon, fantasy or mild violence and/or infrequent use of mild language.",
          "descriptionHtml": "Free Meditation &amp; Sleep Made Easy — Always Free.<br><br>Join 4 million+ people finding calm with Medito, your pocket‑size studio for guided meditation, mind…"
        },
        "rank": 2,
        "country": "US"
      }
    ],
    "page": {"index": 1, "size": 21},
    "fetchedAt": "2026-10-30T00:57:28.064Z"
  }
}

错误

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

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

价格

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

Search

请求

参数

响应

错误

价格

本页内容