Skip to content

Google 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"

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 Parameter api_key open search required
engine string No Set parameter to google (default) to use the Google API engine. google
q string Yes Parameter defines the query you want to search. You can use anything that you would use in a regular Google search. e.g. inurl:, site:, intitle:. We also support advanced search query parameters such as as_dt and as_eq. See the full list of supported advanced search query parameters.
hl string No Parameter defines the language to use for the Google search. It's a two-letter language code. (e.g., en for English, es for Spanish, or fr for French). Head to the Google languages page for a full list of supported Google languages.
gl string No Parameter defines the country to use for the Google search. It's a two-letter country code. (e.g., us for the United States, uk for United Kingdom, or fr for France). Head to the Google countries page for a full list of supported Google countries.
date string No Parameter time last hour=h last day=d last week=w last month=m last year=y
start number No Parameter defines the result offset. It skips the given number of results. It's used for pagination. (e.g., 0 (default) is the first page of results, 10 is the 2nd page of results, 20 is the 3rd page of results, etc.).
num number No Parameter defines the maximum number of results to return. (e.g., 10 (default) returns 10 results, 40 returns 40 results, and 100 returns 100 results).
device string No Parameter defines the device to use to get the results. Currently only supports desktop version.
google_domain string No Parameter defines the Google domain to use. It defaults to google.com. Head to the Google domains page for a full list of supported Google domains.
cr string No Parameter defines one or multiple countries to limit the search to. It uses country{two-letter upper-case country code} to specify countries and | as a delimiter. (e.g., countryFR|countryDE will only search French and German pages). Head to the Google cr countries page for a full list of supported countries.
lr string No Parameter defines one or multiple languages to limit the search to. It uses lang_{two-letter language code} to specify languages and | as a delimiter. (e.g., lang_fr|lang_de will only search French and German pages). Head to the Google lr languages page for a full list of supported languages.
tbs string No Parameter defines advanced search parameters that aren't possible in the regular query field. (e.g., advanced search for patents, dates, news, videos, images, apps, or text contents). (to be searched)
safe string No Parameter defines the level of filtering for adult content. It can be set to active or off, by default Google will blur explicit content. off or active
nfpr string No Parameter defines if the filters for 'Similar Results' and 'Omitted Results' are on or off. It can be set to 1 (default) to enable these filters, or 0 to disable these filters. 1 or 0 0
filter string No Parameter defines the exclusion of results from an auto-corrected query when the original query is spelled wrong. It can be set to 1 to exclude these results, or 0 to include them (default). Note that this parameter may not prevent Google from returning results for an auto-corrected query if no other results are available. 1 or 0 1
tbm string No Parameter defines the type of search you want to do. It can be set to: all:Google Search, isch:Google Images API, lcl:Google Local API, vid:Google Videos API, nws:Google News API, shop:Google Shopping API, pts:Google Patents API, bks:Google Books API
ludocid string No Parameter defines the id (CID) of the Google My Business listing you want to scrape. Also known as Google Place ID.
lsig string No Parameter that you might have to use to force the knowledge graph map view to show up. You can find the lsig ID by using our Local Pack API or Google Local API.lsig ID is also available via a redirect Google uses within Google My Business.
kgmid string No Parameter defines the id (KGMID) of the Google Knowledge Graph listing you want to scrape. Also known as Google Knowledge Graph ID. Searches with kgmid parameter will return results for the originally encrypted search parameters. For some searches, kgmid may override all other parameters except start, and num parameters.
si string No Parameter defines the cached search parameters of the Google Search you want to scrape. Searches with si parameter will return results for the originally encrypted search parameters. For some searches, si may override all other parameters except start, and num parameters. si can be used to scrape Google Knowledge Graph Tabs
ibp string No Parameter is responsible for rendering layouts and expansions for some elements (e.g., gwp;0,7 to expand searches with ludocid for expanded knowledge graph).
uds string No Parameter enables to filter search. It's a string provided by Google as a filter. uds values are provided under the section: filters with uds, q and serpapi_link values provided for each filter.
html string No Parameter html 1 or 0 0

Response Parameters Description

{
  "code": 200,
  "msg": "string",
  "reqId": "string",
  "data": {
    "search_metadata": {
      "created_at": "2025-10-29 08:53:31",
      "google_url": "https://www.google.com/search?q=coffee",
      "id": "1983336358118166528",
      "json_endpoint": "oss_json",
      "processed_at": "2025-10-29 08:53:33",
      "raw_html_file": "oss_html",
      "status": "Success",
      "total_time_taken": 0
    },
    "search_information": {
      "organic_results_state": "string",
      "page_number": 0,
      "time_taken_displayed": 0,
      "total_results": "string"
    },
    "search_parameters": {
      "google_domain": "string",
      "html": "string",
      "num": "string",
      "q": "string",
      "sourceid": "string",
      "tbm": "string"
    },
    "ads": [
      {
        "ad_type": "string",
        "position": 0,
        "source_logo": "string",
        "source_domain": "string",
        "source_url": "string",
        "title": "string",
        "snippet": "string",
        "redirect_link": "string",
        "displayed_link": "string",
        "source": "string",
        "gps_coordinates": {}
      },
      {
        "position": 0,
        "title": "string",
        "source": "string",
        "thumbnail": "string",
        "reviews": "string",
        "price": "string",
        "extracted_price": "string",
        "tracking_link": "string",
        "rating": "string"
      }
    ],
    "imgs": [
      {
        "image": "string",
        "position": 0,
        "source_name": "string",
        "source_url": "string",
        "title": "string"
      }
    ],
    "knowledge_graph": {
      "title": "string",
      "knowledge_graph_search_link": "string",
      "header_images": [
        {
          "image": "string",
          "source": "string",
          "alt": "string"
        }
      ],
      "web_results": [
        {
          "title": "string",
          "link": "string",
        }
      ],
      "customer_service": "string",
      "customer_service_links": [],
      "founders": "string",
      "founders_links": [
        {
          "text": "string",
          "link": "string"
        }
      ],
      "founded": "string",
      "founded_links": [
        {
          "text": "string",
          "link": "string"
        }
      ],
      "ceo": "string",
      "ceo_links": [
        {
          "text": "string",
          "link": "string"
        }
      ],
      "headquarters": "string",
      "headquarters_links": [
        {
          "text": "string",
          "link": "string"
        }
      ],
      "coo": "string",
      "coo_links": [
        {
          "text": "string",
          "link": "string"
        }
      ],
      "rating": "string",
      "review_count": "string",
      "people_also_see_more_link": "string",
      "people_also_search_for_stick": "string",
      "profiles": [
        {
          "name": "string",
          "link": "string",
          "image": "string"
        }
      ],
      "entity_type": "string",
      "header_images": [
        {
          "image": "string",
          "source": "string",
        }
      ],
      "people_also_search_for": [
        {
          "name": "string",
          "link": "string"
        }
      ]
    },
    "last_page": "string",
    "local_map": {
      "image": "string",
      "link": "string"
    },
    "local_results": {
      "more_locations_link": "string",
      "places": [
        {
          "position": 0,
          "place_id": "string",
          "title": "string",
          "type": "string",
          "rating": "string",
          "reviews_original": "string",
          "thumbnail": "string",
          "hours": "string",
          "address": "string",
          "price": "string",
          "description": "string",
        }
      ]
    },
    "organic_results": [
      {
        "position": 0,
        "title": "string",
        "displayed_link": "string",
        "link": [],
        "redirect_link": "string",
        "snippet": "string",
        "snippet_highlighted_words": [],
        "source": [],
        "source_logo": [],
        "thumbnail": "string",
        "reviews": "string",
        "sitelinks": [
          {
            "snippet": "string",
            "link": "string",
            "title": "string"
          }
        ],
        "date": "string",
        "marker": {
          "name": "string",
          "link": "string"
        },
        "rating": "string",
        "info_link": "string"
      }
    ],
    "pagination": {
      "current": "string",
      "next": "string",
      "other_pages": {
        "1": "string",
        "2": "string"
      }
    },
    "people_also_ask": [
      {
        "date": "string",
        "displayed_link": "string",
        "link": "string",
        "question": "string",
        "snippet": "string",
        "source_logo": "string",
        "title": "string",
        "type": "string",
        "text_blocks": [
          {
            "title": "string",
            "snippet": "string",
            "source": "string",
            "logo_image": "string",
            "link": "string",
            "image": "string"
          }
        ]
      }
    ],
    "people_also_search_for": [
      {
        "block_position": 0,
        "link": "string",
        "query": "string",
        "thumbnail": "string"
      }
    ],
    "people_are_saying": [
      {
        "author": "string",
        "date": "string",
        "extensions": [],
        "image": [],
        "position": 0,
        "source_name": "string",
        "source_url": [],
        "title": []
      }
    ],
    "products": [
      {
        "category": "string",
        "delivery": [],
        "extensions": [],
        "original_price": "string",
        "price": "string",
        "product_id": "string",
        "rating": "string",
        "reviews": "string",
        "source": "string",
        "source_logo": "string",
        "thumbnail": "string",
        "title": "string"
      }
    ],
    "spotlighting_news": [
      {
        "position": 1,
        "title": "Trump tariffs live updates: Trump downplays China tensions; Goldman sees US consumers paying 55% of costs",
        "link": "https://finance.yahoo.com/news/live/trump-tariffs-live-updates-trump-downplays-china-tensions-goldman-sees-us-consumers-paying-55-of-costs-162418187.html",
        "source": "Yahoo Finance",
        "thumbnail": [
          "data:image/jpeg;base64,"
        ],
        "date": "14 hours ago"
      }
    ],
    "videos": [
      {
        "date": "string",
        "duration": "string",
        "image": [],
        "link": "string",
        "platform": "string",
        "position": 0,
        "source": "string",
        "title_video": "string"
      }
    ],
    "population_chart": {
      "type": "population_graph",
      "place": "United States",
      "population": "340.1 million",
      "year": "2024",
      "other": [
        {
          "place": "United States",
          "population": "340.1 million",
          "link": "https://www.google.com/search?lr=lang_en&sca_esv=3c78addd28f7a980&hl=en&q=united+states+population&stick=H4sIAAAAAAAAAOPgUeLUz9U3sEw2LzfQMkxJtLPSU1PTK60yslPTizJzM-LLy4B0sUlmcmlOfFFqekgoYL8gtlcsGwXox0XwgAhcgyw5elAGWCWlFdFln6oA5lsDeKLyDBgEatEaV5mSWqKAkhZarECQgoAzBULVB0BAAAA&sa=X&ved=2ahUKEwiNhuv-4sWQAxVLW0EAHWVrM-oQth96BAg6EAI"
        }
      ],
      "source": [
        {
          "link": "https://www.census.gov/programs-surveys/popest.html",
          "text": "United States Census Bureau"
        }
      ]
    },
    "recipes": [
      {
        "position": 1,
        "title": "Best Ever Chewy Brownies",
        "link": "https://handletheheat.com/chewy-brownies/",
        "source": "Handle the Heat",
        "rating": "4.9",
        "reviews": "1.3K",
        "min_str": "45 min",
        "ingredients_list": [
          "Cocoa powder, chocolate chips, avocado, egg yolk, sea salt"
        ],
        "thumbnail": "data:image/jpeg;base64,"
      }
    ],
    "discussions_and_forums": [
     {
        "title": "Besides this Subreddit, What Forums/Other Places Do You Go For ...",
        "link": "https://www.reddit.com/r/TwoBestFriendsPlay/comments/1az3blr/besides_this_subreddit_what_forumsother_places_do/",
        "source": "Reddit",
        "date": "1 year ago",
        "extensions": [
          "r/TwoBestFriendsPlay",
          "30+ comments"
        ],
        "answers": [
          {
            "snippet": "1. Cut down on sugar, start a sugar free diet and follow that atleast for 21 days, this will ...",
            "link": "https://www.quora.com/What-s-the-best-way-to-lose-weight-quickly-and-effectively?top_ans=1477743693588374",
            "extensions": [
              "Top answer",
              "118 votes",
              "2 years ago"
            ],
            "source_logo": "data:image/png;base64,"
          }
        ]
      }
    ],
    "things_to_know": [
      {
        "text": "Gameplay Locations",
        "question": "Where can I play Counter-Strike?",
        "snippet": "An AI Overview is not available for this search Can't generate an AI overview right now. Try again later. AI Overview You can play Counter-,",
        "references": [
          {
            "title": "Counter-Strike 2 on Steam",
            "snippet": "System Requirements. Windows. SteamOS + Linux. Minimum: OS: Windows® 10. Processor: 4 hardware CPU threads - Intel® Core™ i5 750 o...",
            "logo_image": "data:image/png;base64,",
            "source": "Steam",
            "link": "https://store.steampowered.com/app/730/CounterStrike_2/#:~:text=System%20Requirements,Sound%20Card:%20Highly%20recommended"
          }
        ]
      }
    ],
    "top_musics": [
      {
        "position": 3,
        "title": "Yi Hou Bie Zuo Peng You (Eric Chou)",
        "link": "https://www.google.com/search?ca_esv=53a9b0789629cd9b&q=Yi+Hou+Bie+A6",
        "thumbnail": "data:image/jpeg;base64,"
      }
    ],
    "top_games": [
      {
        "position": 1,
        "title": "Where Winds Meet",
        "link": "https://www.google.com/search?esv=53a9b0789629cd9b&q=Where+Winds+Meet&stick=H4sIAAAAAAAAA AFWRP0zUUBzHryCXo2DCHSES0X62I7v3YAQdZRAEMPY0H-v19e-99M8bdXHTMOjuxKA7MdEQNxkcjGExcTARw2CcSBw9sH3EJk36ed_3-_5-v28bU-2bHdQBIDWtoFtwW539-cvDs6Ojs6fPTqT_1RNpuhN1FJuwzBIaJsBh2K4Y--",
        "kgmid": "/g/11v_bj5yzc",
        "thumbnail": "data:image/jpeg;base64"
      }
    ],
    "books_result": [
      {
        "name": "Rocket Man: Elon Musk In His Own Words",
        "extensions": [
          "2017"
        ],
        "link": "https://www.google.com/search?sca_esv=bdbe2dd8fffd653b&gl=us&hl=en&q=Rocket+Man:+Elon+Musk+In+His+Own+Words&stick=H4sIAAAAAAAAAONgFuLUz9U3MM6rSjNU4tVP1zc0TKuyyMg2tzTWkspOttJPys_P1k8sLcnlL7ICsYsV8vNyKhexqgXLJ2enliJ4JuZKbjm5Ocp-JYWZyt45il4ZBYr-JfnKYTnF6UUAwDiXNoZYQAAAA&sa=X&ved=2ahUKEwiO0tDqr6iQAxVOb_UHHdCQD8cQgOQBegQINRAG",
        "image": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRDH7v9b563Jt6tf0DlecrsPzlyeTcM1qYkQbd0F1jAePQ48_upTBls5BoAlkM&s=10"
      }
    ],
    "popular_destinations": [
      {
        "title": "Dubrovnik",
        "link": "https://www.google.com/search?lr=lang_en&sca_esv=60d58b6df421f955&gl=us&hl=en&q=Dubrovnik&si=AMgyJEvmed8FkyEkpEJ8jfGhZkakcy5kQho_c4G-QJRdklshMhRSE_RQi3ZW3k69iZDGQ5TRlc9Qqga-Xx5I2vFdmWtOH-oVWQ%3D%3D&sa=X&ved=2ahUKEwir5Lne0qqQAxXUI0QIHaxrNWcQs4ILegQIMRAD",
        "description": "Walled Old Town, art & Banje beach",
        "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSZLh8z8rt_BRJCeEw9roPmU7nIZJ6nENVOoQLj0JIsJAa2Xv5o_4-UdwbTAYY&s=8",
        "flight_price": "$586",
        "extracted_flight_price": "586",
        "flight_duration": "12h"
      }
    ],
    "flights_results": {
      "type": "google_flights",
      "title": "Flights to Orlando, FL",
      "link": "https://www.google.com/travel/flights?",
      "search_information": {
        "booking_class": "First",
        "trip_type": "Round trip",
        "from": {
          "departing_place": "Austin, TX",
          "departing_airport": "AUS"
        },
        "to": {
          "arriving_place": "Orlando, FL",
          "arriving_airport": "all airports"
        }
      },
      "flights": [
        {
          "link": "https://www.google.com/travel/flights?",
          "icon": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAACAAAAAAgCAYAAABC",
          "flight_info": [
            "Spirit",
            "2h 36m",
            "Nonstop",
            "from $421"
          ]
        },
      ],
      "cheap_flights": [
        {
          "departure_date": "2025-10-16",
          "return_date": "2025-10-17",
          "price": "$750",
          "percentage_of_highest_price": 38.109756,
          "booking_class": "T"
        }
      ]
    },
    "hotel_results": {
      "query": {
        "location": "Boston, MA",
        "days": [
          "Mon, Oct 27",
          "Tue, Oct 28"
        ],
        "people": "2"
      },
      "type": "Hotels",
      "hotels": [
        {
          "title": "Studio Allston Hotel",
          "link": "https://www.google.com/travel/search?",
          "image": "data:image/jpeg;base64,/9j,",
          "price": "$204",
          "rating": 4,
          "reviews": "859"
        }
      ]
    },
    "latest_posts": [
      {
        "title": "Starship will make life multiplanetary",
        "link": "https://x.com/elonmusk/status/1978343307366252865?ref_src=twsrc%5Egoogle%7Ctwcamp%5Eserp%7Ctwgr%5Etweet",
        "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcSaGrsGcdyh0OzyllXhlzeMDZ0G0JCwmiQzZedukgECeDhvpXQE7I6Ift2Ltf1f6qhjDTc2hlIJ&s=10",
        "source": "X",
        "source_icon": "https://ssl.gstatic.com/diner/images/twitter_icon.png",
        "channel": "elonmusk",
        "channel_icon": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcTH87ALFqAAzvaUpLcPKIVJmKkUzdOq9HduzE73tWGXwinaRdQ_PcUeSA&s=10",
        "date": "1 day ago",
        "likes": "195.2K+ likes"
      }
    ]
  }
}

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
page_number number Current page number (indicating the current pagination index of the search results, used for browsing search results by pages) desktop
time_taken_displayed number TDisplay time (i.e., the time spent on displaying the search results) desktop
total_results 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
gl string Used to specify the country or region scope of the search results desktop
hl string Used to specify the language of the Google search interface 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

ads

object[] Ad results, description of core information for Google Search "paid advertisements (ads)", covering ad types, display positions, sources, etc.

Parameter Type Description Applicable Terminal
ad_type string Ad type identifier (such as "Sponsored" indicating "sponsored ads") desktop
position number Position/rank of the search result (identifying the order of the result in the list) desktop
source_logo string Brand logo identifier of the ad source (advertiser), usually a simplified encoding/placeholder/image link used to display the advertiser's visual identity desktop
source_domain string Advertiser's website domain (such as land.yunlogin.com) desktop
source_url string Advertiser's direct landing page link desktop
title string Core title of the advertisement, used to quickly convey the product name (such as Yunlogin Fingerprint Browser) and attract the attention of target users desktop
snippet string Advertisement summary/description, the expanded summary content (a concise answer extracted from the webpage) desktop
redirect_link string Advertisement redirect tracking link (Google Ads specific) desktop
displayed_link string Simplified link displayed to users for the advertisement on the interface desktop
source string Advertisement source identifier, consistent with the meaning of source_domain desktop
gps_coordinates object Geographical coordinates associated with the advertisement (such as latitude and longitude). If it is an empty object, it indicates that the advertisement is a "non-local advertisement" desktop
thumbnail string Thumbnail link, which can be used to display a small preview image of the hotel desktop
reviews string Information related to the number of reviews/ratings desktop
price string Hotel price desktop
extracted_price string Extracted pure price value desktop
tracking_link string Tracking link, which may involve advertising tracking, etc. desktop
rating string Hotel rating desktop

imgs

object[] Image results, image-related modules embedded in web search and content aggregation scenarios (such as albums, news, products)

Parameter Type Description Applicable Terminal
position number Position/rank of the search result (identifying the order of the result in the list) desktop
title string Title of the content associated with the image desktop
source_url string URL of the source page associated with the image content desktop
image string Thumbnail link (address of a small preview image related to the content, used for quick visual identification, including data:image/png;base64) desktop
source_name string Source platform name of the image-related content (such as "Spotify") desktop

knowledge_graph

object Knowledge graph results, (Combining information collections of people, events, organizations, etc.), transforming internet information into structured entity networks, enabling search engines to understand things themselves. The combination of knowledge graphs and multimodal technology expands the boundaries of search

Parameter Type Description Applicable Terminal
title string The name/title of this knowledge graph desktop
entity_type number Numeric identifier for distinguishing types (using numbers to differentiate entity categories, such as "enterprise", "person", "product", etc.) desktop
knowledge_graph_search_link string Link to the knowledge graph search page (click to view the complete display of the entity in the knowledge graph) desktop
header_images[] object[] Collection of header display images (such as brand banner images) desktop
header_images[].image string Base64 encoded string of the image desktop
header_images[].source string Image source link desktop
header_images[].alt string Alternative text for the image, used for descriptions when the image fails to load or for accessibility purposes desktop
web_results[] object[] Collection of related web search results desktop
web_results[].link string Web link desktop
web_results[].title string Web title desktop
customer_service string Customer service related information (such as phone number) desktop
customer_service_links string[] Collection of customer service related links desktop
founders string Founder information (name of the founder of the enterprise/organization) desktop
founders_links object[] Collection of founder-related links (such as founder profile page, related news URLs) desktop
founders_links[].text string Founder's name desktop
founders_links[].link string Google search link for the founder desktop
founded string Establishment date (the founding date of the enterprise/organization) desktop
founded_links object[] Google search link for the company's establishment location, convenient for understanding details about the founding place desktop
founded_links[].text string Text description of establishment date related links (such as the display text "Founded in 1998") desktop
founded_links[].link string Links related to establishment date desktop
ceo string Chief Executive Officer (CEO) name desktop
ceo_links object[] Current CEO's Google search link, convenient for viewing their profile/news desktop
ceo_links[].text string Text description of CEO-related links (such as the display text of the CEO's name and position description) desktop
ceo_links[].link string CEO-related links (URLs for CEO biography, interview reports, etc.) desktop
headquarters string Headquarters address (the location of the enterprise/organization's headquarters) desktop
headquarters_links object[] Google search link for the headquarters location, convenient for understanding the headquarters address/surrounding information desktop
headquarters_links[].text string Text description of headquarters address related links (such as the display text "Headquartered in Mountain View, California") desktop
headquarters_links[].link string Links related to headquarters address desktop
coo string Chief Operating Officer (COO) name desktop
coo_links object[] Current COO's Google search link, convenient for viewing their professional profile desktop
coo_links[].text string Text description of COO-related links (display text of COO name and position description) desktop
coo_links[].link string COO-related links desktop
rating string Rating (user reputation, product rating, etc.) desktop
review_count string Number of reviews (total count of user reviews) desktop
people_also_see_more_link string Redirect link (URL that guides to view more related content) desktop
people_also_search_for_stick string Fixed recommendation collection (popular content that users frequently associate with searches) desktop
profiles object[] Social/official profiles collection desktop
profiles[].name string Profile name (such as "Official YouTube Channel", "Instagram Homepage") desktop
profiles[].link string Profile link (URL of the corresponding platform/official page) desktop
profiles[].image string Image link (URL of social account avatar, cover image, etc.) desktop
people_also_search_for[] object[] Recommendation collection (other content that users search for simultaneously when searching for the current keyword) desktop
people_also_search_for[].name string Recommendation name (recommended keyword text) desktop
people_also_search_for[].link string Recommendation link (URL of the corresponding search results page) desktop

local_map

object Local map, visually display merchant locations, allowing users to preview surrounding environment via map, or click merchant listings to view business hours

Parameter Type Description Applicable Terminal
image string Resource link for the map image displayed in the local map module desktop
link string Redirect link for local map location desktop

local_results

object Local search results, listing milk tea shops in the area and marking key information such as distance, rating, and address

Parameter Type Description Applicable Terminal
more_locations_link string Redirect link to **"More locations" desktop
places object[] List containing information of multiple locations/businesses desktop
places[].position number The position/rank of this location in the search results list desktop
places[].place_id string Unique identifier of the location (used in map services to uniquely mark the location for data association) desktop
places[].title string Name of the location/business desktop
places[].type string Type/category of the location/business (such as "coffee shop", "restaurant", indicating business attributes) desktop
places[].rating string Rating of the location/business desktop
places[].reviews_original string Original user reviews of the location/business (including review text, reviewer information, and other unprocessed comment data) desktop
places[].thumbnail string Thumbnail link of the location/business (small-sized image address for quick preview, such as product images) desktop
places[].hours string Business hours of the location/business desktop
places[].address string Address of the location/business desktop
places[].price string Price level (consumption level) desktop
places[].description string Brief description of the location desktop

organic_results

object[] Organic search results, these are Google's algorithm-recommended, non-paid promotional core search results, and also the primary source of information for users

Parameter Type Description Applicable Terminal
position number Position/rank of the search result (identifying the order of the result in the list) desktop
title string Title of the entry (name summarizing the core content, such as webpage title) desktop
link string[] Target link of the result (original URL address to which clicking redirects) desktop
source string[] Source of the content (such as website name, media platform, or other source identifiers) desktop
source_logo string[] Source logo link (the image address of the content source brand logo, usually in the format data:image/png;base64) desktop
redirect_link string Redirect link desktop
displayed_link string Display link (simplified and formatted link used for page display, easy to read) desktop
snippet_highlighted_words string[] Highlighted keywords in the summary (words that match the search term and need to be emphasized) desktop
snippet string Content summary (a brief description of the core information) desktop
reviews string User review information (including the number of reviews) desktop
sitelinks string[] "Internal website links", i.e., a collection of links within the search results that point to other related subpages within the target website. desktop
sitelinks[].snippet string Summary of the website internal link sub-item desktop
sitelinks[].link string Target link of the website internal link sub-item desktop
sitelinks[].title string Title of the website internal link sub-item desktop
date string Content date (publication date or update date, usually in the format "year-month-day") desktop
thumbnail string Thumbnail link (address of a small preview image related to the content, used for quick visual identification, including data:image/png;base64) desktop
marker object Object containing related tag information desktop
marker.name string Name of the tag desktop
marker.link string Link pointing to related resources desktop
rating string User's star rating for the product desktop
info_link string Information link (link to a more detailed information page, such as a supplementary description page for the content) desktop

pagination

object Pagination information (parameters or display logic controlling search result pagination)

Parameter Type Description Applicable Terminal
current number Current page number desktop
next string Next page navigation link (can directly jump to the next page of search results) desktop
other_pages object An object containing navigation links to other pages (such as page 2, page 3, etc.) desktop

people_also_ask

object[] People also ask, based on user search behavior data and content relevance algorithms, automatically organizes other frequently asked questions closely related to the current search topic

Parameter Type Description Applicable Terminal
question string Display related questions text desktop
type string Question type identifier (used to distinguish question categories) desktop
snippet string Expanded question summary content (concise answers extracted from web pages) desktop
title string Content title providing the answer (such as the source webpage title) desktop
link string Target link for full content (click to navigate to the webpage containing detailed answers) desktop
displayed_link string Display link (simplified and formatted link for easy-to-read page presentation) desktop
source_logo string Source logo link (image address of the content origin brand identifier, typically in data:image/png;base64 format) desktop
date string Content date (publication or update date, typically in "YYYY-MM-DD" format) desktop
text_blocks object[] Text block related information collection desktop
text_blocks[].title string Content title, used to summarize the core topic, such as the title of articles, videos, etc. desktop
text_blocks[].snippet string Content snippet, briefly displaying key information desktop
text_blocks[].source string Content source desktop
text_blocks[].logo_image string Base64 encoded JPEG identifier image desktop
text_blocks[].link string Related content link desktop
text_blocks[].image string Base64 encoded GIF related image desktop

people_also_search_for

object[] People also search, based on current search keywords, combined with user group search behavior data, recommends other search terms related to the current topic, helping users expand their search scope and discover more related information

Parameter Type Description Applicable Terminal
block_position number Content block position identifier (used to indicate the sorting/order and position of the content block within the overall layout or result list) desktop
query string User's query term/search keyword (the keyword text that triggers the search and retrieves content) desktop
link string Target URL for resource (click-through destination) desktop
thumbnail string Thumbnail image URL (small preview image for quick visual identification) desktop

people_are_saying

object[] What people are saying, Module (for "Public Reviews/Public Opinion Aggregation" module) integrates multi-dimensional perspectives, user reviews, or public feedback related to the search topic

Parameter Type Description Applicable Terminal
position number Search result position/rank (indicating the order of the result in the list) desktop
author string Author of content/originating community desktop
extensions stirng[] Content extension identifier collection (tags such as "popular comments", "latest comments", etc.) desktop
title string[] Core content title list, used to quickly convey product names (e.g., Yundeng Fingerprint Browser) and attract target user attention desktop
source_url string[] Original content link (click to navigate to the original post for full content) desktop
image string[] Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64) desktop
source_name string Name of the platform where content originates desktop
date string Content date (publication or update date, typically in "YYYY-MM-DD" format) desktop

products

object[] Product results, module aggregates product data from massive e-commerce platforms (such as Amazon, Best Buy, brand websites, etc.) and directly displays key content like product images, real-time prices, brands, user ratings, and seller information on the search results page

Parameter Type Description Applicable Terminal
category string Product category (e.g., "Electronics", "Mobile Phones", used for classifying products) desktop
delivery string[] Product shipping information (e.g., "Free delivery" indicates free shipping) desktop
extensions string[] Product extended information (e.g., promotional tag "63% Off") desktop
original_price string Product original price (price before discount) desktop
price string Current product price (real-time purchase price display) desktop
product_id string Product ID (unique code for identifying individual products within the system) desktop
rating string Product rating (user star rating for the product) desktop
reviews string Product customer feedback data (containing number of reviews) desktop
source string Product origin platform (such as Walmart) desktop
source_logo string Source platform logo link (image address displaying the merchant's brand identifier) desktop
thumbnail string Thumbnail image URL (small preview image for quick visual identification) desktop
title string Title for product showcase desktop

spotlighting_news

object[] Spotlight news, An array of focused news, used to display important/prominent news content

Parameter Type Description Applicable Terminal
date string Content date (publication or update date, typically in "YYYY-MM-DD" format) desktop
link string News article link (click-through to full news story) desktop
position number News position in "focus list" (ranking order within the spotlight news list) desktop
source string News source media/platform (e.g., "Yahoo") desktop
source_logo string Source logo link (image address of the content origin brand identifier, typically in data:image/png;base64 format) desktop
thumbnail string[] Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64) desktop
title string News title (e.g., "Trump Tariff Updates") desktop

videos

object[] Video search results, (video search results module) provides users with intuitive, dynamic video information, with video results accompanied by title, duration, publishing platform, publication date, thumbnail and other information

Parameter Type Description Applicable Terminal
date string Content date (publication or update date, typically in "YYYY-MM-DD" format) desktop
duration string Video duration desktop
image string[] Video thumbnail links (users can quickly perceive video visual content through thumbnails) desktop
link string Video player page URL (such as YouTube video link) desktop
platform string Video platform (e.g., YouTube) desktop
position number Video position in "video search results list" (ranking order within the video search results) desktop
source string Video source/publisher desktop
title_video string Video title, used to summarize the core content of the video desktop

population_chart

object Demographic statistics visualization charts, used to visually display population quantity, distribution, structure, or trends

Parameter Type Description Applicable Terminal
type string Chart type of the data, explicitly specified as population-related charts desktop
place string Geographical region corresponding to the data desktop
population string Population count for the corresponding region desktop
year string Statistical year corresponding to the population data desktop
other object[] Array of supplementary US population-related information, can contain multiple sets of repeated or extended demographic data desktop
other[].place string Geographical region in supplementary information desktop
other[].population string Population count in supplementary information desktop
other[].link string URL for detailed US population data search results desktop
source object[] Array of population data source information desktop
source[].link string Official website URL of the data source institution (U.S. Census Bureau) desktop
source[].text string Name of the data source institution desktop

recipes

object[] (Recipes) User needs for "finding recipes, learning cooking, and exploring cuisine"

Parameter Type Description Applicable Terminal
position number Ranking order of the recipe within search results desktop
title string Recipe title desktop
link string Recipe detail page URL link (click to navigate to the complete recipe page) desktop
source string Originating platform or site name for the recipe desktop
rating string Recipe star rating (customer evaluation score given to the recipe) desktop
reviews string Number of reviews for the recipe desktop
min_str string Time required to prepare the recipe desktop
ingredients_list string[] Recipe ingredients list (in array format) desktop
thumbnail string Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64) desktop

discussions_and_forums

object[] Show relevant discussion threads from Reddit, Quora matching search queries

Parameter Type Description Applicable Terminal
title string Title of related content (such as forum discussions, etc.) desktop
link string Content link address, through which the specific content can be accessed desktop
source string Name of the platform where content originates desktop
date string Content publication time information desktop
extensions string Used to store additional relevant information desktop
source_logo string Source platform logo desktop
answers string[] List of answers under the discussion, containing specific answer content, links, and additional information desktop
answers[].snippet string Brief excerpt of the answer desktop
answers[].link string Specific link to the answer desktop
answers[].extensions string Extended information list for the answer, including whether it's a pinned answer, vote count, publication time, etc. desktop

things_to_know

object[] ("Key points to know" module) Key knowledge and core questions related to the search topic, helping users quickly obtain essential information

Parameter Type Description Applicable Terminal
text string Theme/keywords of related questions desktop
question string Specific questions related to the key points desktop
snippet string Summary content (typically system-generated answer snippets) desktop
references object[] List of reference links for the information source desktop
references[].title string Source page title desktop
references[].snippet string Content summary of the reference page desktop
references[].logo_image string Logo image of the source website or platform (Base64 encoded or URL) desktop
references[].source string Content source platform name desktop
references[].link string Complete URL of the original reference page desktop

top_musics

object[] (Popular music related content) Displays multidimensional popular music collections such as "Annual Hot Singles" and "Genre Hits (e.g., Pop/Rock/Hip-Hop Top Charts)"

Parameter Type Description Applicable Terminal
position number Ranking order of the content within search results desktop
title string Content title desktop
link string Link to the content (click to navigate to the relevant search results page) desktop
thumbnail string Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64) desktop

top_games

object[] (Popular games related content) Helps users quickly grasp global gaming trends, discover quality titles, and optimize gaming experience

Parameter Type Description Applicable Terminal
position number Ranking order of the game within the popular games listing desktop
title string Name of the game (such as "Where Winds Meet") desktop
link string URL link to the game's Google search results page desktop
kgmid string Unique identifier for Google Knowledge Graph desktop
thumbnail string Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64) desktop

books_result

object[] Book search results

Parameter Type Description Applicable Terminal
name string Name of the book desktop
extensions string[] Contains extended information related to books desktop
link string Link to book-related search results, through which more information about the book can be obtained desktop
image string Link to book cover or related images, used to display the visual content of the book desktop

object[] Basic information of popular destinations, such as attraction lists

Parameter Type Description Applicable Terminal
title string Name of the popular destination desktop
link string Link to the popular destination's Google search results page, click to view more detailed search content desktop
description string Brief characteristic description of the popular destination desktop
thumbnail string Thumbnail image link related to the popular destination, used to display visual preview of the destination (such as scenic views, iconic landmarks thumbnails) desktop
flight_price string Flight price to reach the destination desktop
extracted_flight_price string Flight price numeric value desktop
flight_duration string Approximate flight duration to the destination desktop

flights_results

object[] Google Flights helps users efficiently search, compare, and book flights

Parameter Type Description Applicable Terminal
type string Result type (e.g., google_flights) desktop
title string Search topic title desktop
link string Base link for Google Travel flight search, leading to the flight search page desktop
search_information object Flight search parameters object desktop
search_information[].booking_class string Seat class (such as First Class) desktop
search_information[].trip_type string Trip type (e.g., Round trip) desktop
search_information[].from object Collection object of departure information desktop
search_information[].from.departing_place string Departure city desktop
search_information[].from.departing_airport string IATA code of the departure airport desktop
search_information[].to object Collection object of destination information desktop
search_information[].to.arriving_place string Arrival city desktop
search_information[].to.arriving_airport string Scope of destination airports desktop
flights object[] Array of specific flight options, with each element corresponding to one flight desktop
flights[].link string Detailed link for the flight on Google Travel desktop
flights[].icon string Thumbnail link (data:image/png;base64) desktop
flights[].flight_info string[] Array of flight key information desktop
cheap_flights object[] Array of low-price flight information, with each element corresponding to a cost-effective flight desktop
cheap_flights[].departure_date string Departure date desktop
cheap_flights[].return_date string Return date desktop
cheap_flights[].price string Low-price flight cost desktop
cheap_flights[].percentage_of_highest_price number Ratio of this price relative to the "highest price" desktop
cheap_flights[].booking_class string Cabin class of the low-price flight desktop

hotel_results

object Structured data module displaying hotel-related information, designed to help users efficiently discover, compare, and book accommodations

Parameter Type Description Applicable Terminal
query object Collection of hotel search query parameters desktop
query.location string Hotel search location (e.g., Boston) desktop
query.days string[] Array of check-in and check-out dates desktop
query.people string Number of guests desktop
type string Result type (e.g., Hotels) desktop
hotels object[] Hotel list array, with each array element being a detailed information object for one hotel desktop
hotels[].title string Hotel name desktop
hotels[].link string Link to the hotel's detail page desktop
hotels[].image string Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64) desktop
hotels[].price string Hotel price desktop
hotels[].rating string Hotel rating (user star rating for the hotel) desktop
hotels[].reviews string Number of reviews for the hotel desktop

latest_posts

object[] Short content (such as latest tweets or posts from Twitter, Instagram, etc. embedded in search results) will be displayed as "Latest Posts" within merchant information in search results

Parameter Type Description Applicable Terminal
title string Title content of the latest post desktop
link string URL to the latest post's detail page desktop
thumbnail string Thumbnail image URL related to the latest post, used to display visual preview of the post desktop
source string Platform name where the post was published desktop
source_icon string Icon image URL of the publishing platform desktop
channel string Account name that published the post desktop
channel_icon string Icon image URL of the publishing account desktop
date string Content date (publication date or update date, typically in "YYYY-MM-DD" format) desktop
likes string Number of likes received by the post desktop

last_page

string (Pagination) related fields used to describe pagination navigation information for search results

Parameter Type Description Applicable Terminal
last_page string Last page (the "last page" indicator when paginating search results) desktop