Google Search API

Basic Information

Interface Description: Retrieve real-time search data from Google via API.

Interface URL: https://scraperapi.thordata.com/request

Request Method: POST

Request parameters

Headers：

Parameter name	Type	Required	Describe
token	string	Yes	Please log in to the Dashboard-account-settings to view your token

Body：

Parameter name	Type	Required	Describe
q	string	Yes	Defines the search query for scraping (default: q=pizza).
json	string	No	This parameter defines the output format of the crawl results. json=1 for JSON, json=2 for both, json=3 for HTML.
url	string	Yes	This defines the domain used during scraping, default is google.com. Modify this or refer to the Google Domains page for a full list of supported domains.
gl	string	No	Specifies the country/region for localized search results. For supported codes, see Google’s Country List.
hl	string	No	Sets the UI language for search results Full list: Google Language Codes.
cr	string	No	Restricts results to specific countries using | as a separator Combine with gl for consistent UI/content language.gl and cr can be combined, but the actual effect follows cr as the priority.
lr	string	No	Filters results by language using lang_XX codes . Overrides hl if both are used. hl andlr can be used together, but the actual effect followslr as the priority.
location	string	No	Simulates searches from a precise location. Must be paired with uule.
uule	string	No	This parameter encodes the selected location using Base64. It is used together with the location parameter. A CSV with all available uule values can be downloaded here.
tbm	string	No	Defines the search result type: tbm=isch – Images tbm=shop – Shopping tbm=nws – News tbm=vid – Videos
start	string	No	Set the pagination starting point for search results .Examples: start=0 (default) - first page of results start=20 - second page of results start=40 - third page of results, etc.
num	string	No	This parameter sets the maximum number of results per page. For example, num=20 (default) - return 20 results num=50 - return 50 results, etc.
safe	string	No	This defines whether to filter adult content. Options: active (enabled) or off (disabled).
ludocid	string	No	Parameter defines the id (CID) of the Google My Business listing you want to scrape. Also known as Google Place ID.
kgmid	string	No	The kgmid parameter is used to directly retrieve encrypted data of specific entries in Google's Knowledge Graph, overriding standard search parameters and returning structured results.
ibp	string	No	Used to control layout rendering and expansion effects for specific elements such as knowledge graph expansion search with ludocid
tbs	string	No	This parameter is used for time/type filtering (supports complex conditions), for example: tbs=qdr:d - Show only content from the last 24 hours tbs=qdr:h - Past 1 hour tbs=qdr:w - Past 1 week tbs=qdr:m - Past 1 month tbs=qdr:y - Past 1 year
nfpr	string	No	Whether to disable autocorrect spelling, for example: nfpr=1, search for 'googl' will not automatically correct to 'google'
filter	string	No	Deduplicates results: 1 (enable), 0 (disable).

Response example

{
    "spider_parameter": {
        "engine": "google",
        "q": "pizza"
    },
    "total": {
        "value": "About 2,240,000,000 results (0.30 seconds) "
    },
    "search_metadata": {
        "created_at": "2025-06-21 14:08:06",
        "id": "xxx",
        "url": "https://www.google.com/search?q=pizza"
    },
    "result":{}

Parameter Name	Type	Required	Description
spider_parameter	object	yes	Search engine parameters configuration
engine	string	yes	Search engine type
q	string	yes	Search keyword
total	object	yes	Total search results information
value	string	yes	Result count and time
search_metadata	object	yes	Metadata of the search
created_at	string	yes	Timestamp of the search
id	string	yes	Unique task ID
url	string	yes	Full URL of the search request
result	string	yes	Return Result