Google Play Search API

GET | POST /v1/google-play/search

Send parameters as a query string with GET, or as a JSON body with POST. Both are equivalent.

Request

curl "https://gateway.apinoa.com/v1/google-play/search?q=meditation&country=US" \
  -H "x-api-key: $APINOA_API_KEY"

Parameters

Parameter	Type	Notes
`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.

The same parameters, and every response type, are in the OpenAPI document.

Response

Returns AppsPage in data. A real response, shortened: arrays keep their first entries and long text is cut.

{
  "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"
  }
}

Errors

Status	Code	Meaning
400	`INVALID_CURSOR`	The `cursor` is not one this operation returned. Start again without it.
400	`INVALID_PARAMS`	A parameter is missing, unknown or out of range, or the engine does not take it. The message names it.
401	`UNAUTHORIZED`	The `x-api-key` header is missing, or the key is revoked or unknown.
402	`INSUFFICIENT_BALANCE`	The balance does not cover this call. Top up in the dashboard.
429	`MARKETPLACE_SATURATED`	Too many concurrent calls. Retry after the `Retry-After` seconds.
502	`UPSTREAM_ERROR`	The engine answered with something unusable. Retry with backoff.
503	`SERVICE_UNAVAILABLE`	A temporary failure. Retry with backoff.

Every code is listed in Errors. Failed calls are not billed.

Pricing

Price $0.0012 per call. List price; the rate steps down above 1,000 calls a day.

Search

Request

Parameters

Response

Errors

Pricing

On this page