Skip to content

Google Play

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"

Request Example

curl -X POST "https://domain/api/v1/open/search" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "your_api_key_here",
    // ...
  }'

Response Format

All responses follow a standardized JSON structure:

{
  "code": 200,
  "msg": "Success",
  "reqId": "req_1234567890",
  "timestamp": "2025-01-08T10:30:00Z",
  "data": {
    // Response data object
  }
}

HTTP Status Codes

Code Status Description Retry
200 OK Request successful 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

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