Google Search

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 Example

bash

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

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.
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).
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.
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 Example

{
  "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
json_endpoint	string	Provide an interface endpoint for searching related JSON data, through which JSON-formatted search data can be obtained
created_at	string	The timestamp when the search request was created, recording the time when the search was initiated
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
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
status	string	Status of the search execution (e.g., Success)
raw_html_file	string	Identifier for the original HTML file
total_time_taken	number	The total time spent on the entire search process (including request sending, result parsing, and other stages)

search_information

object Contains information about the search results

Parameter	Type	Description	Applicable Terminal
organic_results_state	string	State of organic results
page_number	number	Current page number (indicating the current pagination index of the search results, used for browsing search results by pages)
time_taken_displayed	number	TDisplay time (i.e., the time spent on displaying the search results)
total_results	string	Total results count (the total number of results returned by this search)

search_parameters

object Contains the parameters used for the search

Parameter	Type	Description	Applicable Terminal
q	string	Keywords used for this query
engine	string	Search engine used for this query (e.g., google_web)
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.
html	string	When HTML=0, returns JSON; when HTML=1, returns HTML; when HTML=2, returns both JSON and HTML
google_domain	string	Specifies the corresponding Google domain (e.g., google.com, etc., used to distinguish Google services in different regions/locales)

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")
position	number	Position/rank of the search result (identifying the order of the result in the list)
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
source_domain	string	Advertiser's website domain (such as land.yunlogin.com)
source_url	string	Advertiser's direct landing page link
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
snippet	string	Advertisement summary/description, the expanded summary content (a concise answer extracted from the webpage)
redirect_link	string	Advertisement redirect tracking link (Google Ads specific)
displayed_link	string	Simplified link displayed to users for the advertisement on the interface
source	string	Advertisement source identifier, consistent with the meaning of source_domain
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"
thumbnail	string	Thumbnail link, which can be used to display a small preview image of the hotel
reviews	string	Information related to the number of reviews/ratings
price	string	Hotel price
extracted_price	string	Extracted pure price value
tracking_link	string	Tracking link, which may involve advertising tracking, etc.
rating	string	Hotel rating

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)
title	string	Title of the content associated with the image
source_url	string	URL of the source page associated with the image content
image	string	Thumbnail link (address of a small preview image related to the content, used for quick visual identification, including data:image/png;base64)
source_name	string	Source platform name of the image-related content (such as "Spotify")

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

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
link	string	Redirect link for local map location

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

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

pagination

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

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

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

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)
query	string	User's query term/search keyword (the keyword text that triggers the search and retrieves content)
link	string	Target URL for resource (click-through destination)
thumbnail	string	Thumbnail image URL (small preview image for quick visual identification)

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

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

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)
link	string	News article link (click-through to full news story)
position	number	News position in "focus list" (ranking order within the spotlight news list)
source	string	News source media/platform (e.g., "Yahoo")
source_logo	string	Source logo link (image address of the content origin brand identifier, typically in data:image/png;base64 format)
thumbnail	string[]	Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64)
title	string	News title (e.g., "Trump Tariff Updates")

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)
duration	string	Video duration
image	string[]	Video thumbnail links (users can quickly perceive video visual content through thumbnails)
link	string	Video player page URL (such as YouTube video link)
platform	string	Video platform (e.g., YouTube)
position	number	Video position in "video search results list" (ranking order within the video search results)
source	string	Video source/publisher
title_video	string	Video title, used to summarize the core content of the video

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
place	string	Geographical region corresponding to the data
population	string	Population count for the corresponding region
year	string	Statistical year corresponding to the population data
other	object[]	Array of supplementary US population-related information, can contain multiple sets of repeated or extended demographic data
other[].place	string	Geographical region in supplementary information
other[].population	string	Population count in supplementary information
other[].link	string	URL for detailed US population data search results
source	object[]	Array of population data source information
source[].link	string	Official website URL of the data source institution (U.S. Census Bureau)
source[].text	string	Name of the data source institution

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
title	string	Recipe title
link	string	Recipe detail page URL link (click to navigate to the complete recipe page)
source	string	Originating platform or site name for the recipe
rating	string	Recipe star rating (customer evaluation score given to the recipe)
reviews	string	Number of reviews for the recipe
min_str	string	Time required to prepare the recipe
ingredients_list	string[]	Recipe ingredients list (in array format)
thumbnail	string	Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64)

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.)
link	string	Content link address, through which the specific content can be accessed
source	string	Name of the platform where content originates
date	string	Content publication time information
extensions	string	Used to store additional relevant information
source_logo	string	Source platform logo
answers	string[]	List of answers under the discussion, containing specific answer content, links, and additional information
answers[].snippet	string	Brief excerpt of the answer
answers[].link	string	Specific link to the answer
answers[].extensions	string	Extended information list for the answer, including whether it's a pinned answer, vote count, publication time, etc.

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
question	string	Specific questions related to the key points
snippet	string	Summary content (typically system-generated answer snippets)
references	object[]	List of reference links for the information source
references[].title	string	Source page title
references[].snippet	string	Content summary of the reference page
references[].logo_image	string	Logo image of the source website or platform (Base64 encoded or URL)
references[].source	string	Content source platform name
references[].link	string	Complete URL of the original reference page

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
title	string	Content title
link	string	Link to the content (click to navigate to the relevant search results page)
thumbnail	string	Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64)

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
title	string	Name of the game (such as "Where Winds Meet")
link	string	URL link to the game's Google search results page
kgmid	string	Unique identifier for Google Knowledge Graph
thumbnail	string	Thumbnail link (URL of small-sized preview image related to the content, used for quick visual recognition, including data:image/png;base64)

books_result

object[] Book search results

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

popular_destinations

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

Parameter	Type	Description	Applicable Terminal
title	string	Name of the popular destination
link	string	Link to the popular destination's Google search results page, click to view more detailed search content
description	string	Brief characteristic description of the popular destination
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)
flight_price	string	Flight price to reach the destination
extracted_flight_price	string	Flight price numeric value
flight_duration	string	Approximate flight duration to the destination

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

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
query.location	string	Hotel search location (e.g., Boston)
query.days	string[]	Array of check-in and check-out dates
query.people	string	Number of guests
type	string	Result type (e.g., Hotels)
hotels	object[]	Hotel list array, with each array element being a detailed information object for one hotel
hotels[].title	string	Hotel name
hotels[].link	string	Link to the hotel's detail page
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)
hotels[].price	string	Hotel price
hotels[].rating	string	Hotel rating (user star rating for the hotel)
hotels[].reviews	string	Number of reviews for the hotel

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
link	string	URL to the latest post's detail page
thumbnail	string	Thumbnail image URL related to the latest post, used to display visual preview of the post
source	string	Platform name where the post was published
source_icon	string	Icon image URL of the publishing platform
channel	string	Account name that published the post
channel_icon	string	Icon image URL of the publishing account
date	string	Content date (publication date or update date, typically in "YYYY-MM-DD" format)
likes	string	Number of likes received by the post

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)