Google Play

Perform Search

Overview

Method	Endpoint	Version	Description
`POST`	`/api/v1/open/search`	v1	Google Search API endpoint for retrieving search results

Request Headers

Header	Type	Required	Description
`Content-Type`	`string`	Yes	Must be set to `application/json`
`Accept`	`string`	No	Response format (defaults to `application/json`)

Authentication

API Key Authentication

Pass the API key as a request parameter: api_key=your_api_key
Example: "api_key": "your_api_key_here"

HTTP Status Codes

Code	Status	Description	Retry
200	OK	Request successful	No

Response Codes

Code	Description	Retry
200	Request successful	No
400100	Unsupported search engine	No
400200	The search service is temporarily unavailable. Please try again later	No
400300	ForUserQuery contains prohibited content	No
400400	No results found, please adjust keywords and try again	No
400500	Authorization failed, please check your API credentials	No
400600	The request frequency is too high, please try again later	No
400700	You have reached the daily search limit	No
400710	Insufficient Balance	No

Request Parameters

Parameter	Type	Required	Description	Default
`api_key`	`string`	Yes	API key for authentication
`engine`	`string`	Yes	Search engine type, currently engine value is `google_play`	google
`q`	`string`	Yes	Search query, supports regular Google search syntax (like inurl:, site:, intitle:) and advanced search parameters
`gl`	`string`	No	Search country code (e.g., us-United States, uk-United Kingdom, fr-France). Head to the Google countries page for a full list of supported Google countries.
`hl`	`string`	No	Search language code (e.g., en-English, es-Spanish, fr-French). Head to the Google languages page for a full list of supported Google languages.
`device`	`string`	No	Device type, currently only supports desktop version	desktop
`store_device`	`string`	No	Parameter defines the device for sorting results. This parameter cannot be used with apps_category or q parameters. Available options: phone - Phone device (default), tablet - Tablet device, tv - TV device, chromebook - Chromebook device, watch - Watch device, car - Car device
`age`	`string`	No	Parameter defines age subcategory. age works, and should only be used with, apps_category=FAMILY(Kids Apps). It can be set to: AGE_RANGE1 - Ages up to 5, AGE_RANGE2 - Ages 6-8, AGE_RANGE3 - Ages 9-12. The default value for age is:, - All ages up to 12
`html`	`string`	No	Whether to return HTML format, 1-yes, 0-no	0

Response Example

{
    "code": 200,
    "data": {
        "search_metadata": {
            "raw_html_file": "oss_html",
            "total_time_taken": 2.032416469,
            "id": "1985902431212408832",
            "json_endpoint": "oss_json",
            "created_at": "2025-10-29 08:53:31",
            "processed_at": "2025-10-29 08:53:33",
            "google_url": "https://play.google.com/store/search?q=coffee&c=apps",
            "status": "Success"
        },
        "search_information": {
          "time_taken_displayed": 0.042
        },
        "search_parameters": {
            "engine": "google_play",
            "html": "0",
            "google_domain": "play.google.com",
            "q": "coffee",
        },
        "organic_results": [
          {
            "title": "Google Play Games",
            "link": [
              "/store/apps/details?id=com.google.android.play.games"
            ],
            "thumbnail": [
              "https://play-lh.googleusercontent.com/wpRQkfqbkPztp1US6HDr8E41We8GyY-B4CG1PMmWI3WKDk9OeYh4ehXwKIfZB7dm-sc"
            ],
            "description": "Games are more fun with the Google Play Games app. We&#39;ll help you find your next favorite game – from action to puzzles. And with &quot;Instant play,&quot; many games require no installation. Really. Save your progress and track your achievements as you level up. Plus, you can pick up where you left off from any device.<br><br>KEY FEATURES<br>• <b>Instant play:</b> There’s no installation needed – look for the &quot;Instant play&quot; button to instantly play full games.<br>• <b>Built-in Google games:</b> Play Solitaire, Minesweeper, Snake, PAC-MAN, Cricket, and Whirlybird – even when you’re offline.<br>• <b>Save your progress:</b> Your progress is automatically saved to the cloud when you see &quot;Progress saved by Play Games.&quot;<br>• <b>Gamer profile:</b> Create a custom gamer ID, unlock achievements, earn XP, and level up.<br>• <b>Gameplay recording:</b> Easily record and share your best gameplay moments.",
            "product_id": "com.google.android.play.games",
            "rating": "4.0",
            "author": "Google LLC",
            "category": "Entertainment",
            "dowmloads": "5,000,000,000+",
            "feature_image": "https://play-lh.googleusercontent.com/9gOTPuX04WeVNByX9Z1n6T2k11lS3Ds8w7wEX1VQo_lXQ7q1lHEHHkEcUeGTyeGgL0Y7",
            "video": "https://play.google.com/video/lava/web/player/yt:movie:_w8FQfQZ1SA?autoplay=1&embed=play"
          }
        ],
        "related_searches": [
          {
            "link": "https://play.google.com/store/search?q=%E6%B8%B8%E6%88%8F&c=apps",
            "text": "Apps & games"
          }
        ]
    },
    "msg": "string",
    "reqId": "string"
}

Complete Response Parameters Overview

search_metadata

object Contains metadata about the search execution

Parameter	Type	Description	Applicable Terminal
`id`	`string`	Unique identifier for the search request	desktop
`json_endpoint`	`string`	Provide an interface endpoint for searching related JSON data, through which JSON-formatted search data can be obtained	desktop
`created_at`	`string`	The timestamp when the search request was created, recording the time when the search was initiated	desktop
`processed_at`	`string`	The timestamp when the search results were processed and became available for return, recording the time point from processing to completion of the search	desktop
`google_url`	`string`	The Google search URL, which contains the search keyword "coffee" along with language parameters (hl=en for English), regional parameters (gl=us for the United States), and other search parameters, used to redirect to the corresponding Google search page	desktop
`status`	`string`	Status of the search execution (e.g., Success)	desktop
`raw_html_file`	`string`	Identifier for the original HTML file	desktop
`total_time_taken`	`number`	The total time spent on the entire search process (including request sending, result parsing, and other stages)	desktop

search_information

object Contains information about the search results

Parameter	Type	Description	Applicable Terminal
`organic_results_state`	`string`	State of organic results	desktop
`time_taken_displayed`	`number`	TDisplay time (i.e., the time spent on displaying the search results)	desktop
`query_displayed`	`string`	Total results count (the total number of results returned by this search)	desktop

search_parameters

object Contains the parameters used for the search

Parameter	Type	Description	Applicable Terminal
`q`	`string`	Keywords used for this query	desktop
`engine`	`string`	Search engine used for this query (e.g., google_web)	desktop
`html`	`string`	When HTML=0, returns JSON; when HTML=1, returns HTML; when HTML=2, returns both JSON and HTML	desktop
`device`	`string`	Device type used during search (e.g., desktop)	desktop
`google_domain`	`string`	Specifies the corresponding Google domain (e.g., google.com, etc., used to distinguish Google services in different regions/locales)	desktop

organic_results

object[] Google Play Store allows users to browse, download, install, and update a wide variety of applications.

Parameter	Type	Description	Applicable Terminal
`title`	`string`	Content title	desktop
`link`	`string[]`	An array of links pointing to content	desktop
`thumbnail`	`string[]`	An array of thumbnail image URLs used to display small-sized preview images of the content	desktop
`description`	`string`	Content description text	desktop
`product_id`	`string`	Unique identifier (ID) of the product	desktop
`rating`	`string`	Product rating	desktop
`author`	`string`	Author or developer of the product	desktop
`category`	`string`	Product category	desktop
`dowmloads`	`string`	Product download count	desktop
`feature_image`	`string`	Featured image link	desktop
`video`	`string`	Link to related video	desktop

related_searches

object[] Related searches: search result suggestions provided to optimize queries and explore

Parameter	Type	Description	Applicable Terminal
`link`	`string`	Link to related search results that redirects to the corresponding Google Play Store search page	desktop
`text`	`string`	Text description of the related search result, used to display the thematic content of the related search	desktop