Google Trends

SERP API Google Query Parameters

Configure Google search queries using Thordata’s SERP API, including Geographical Location parameters, search type, and "advanced parameter" output options.

q ,Search Query(Required)

Define the search query used for data scraping (Default value: q=pizza). Any keywords in any language are supported.

Example Request: Example using the parameter q: pizza

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1"

Geographical Location

hl ,Language(Optional)

Set the interface language for search results (default value: en). Adopt standard language code formats (e.g., en, es, zh-CN).

For the complete list of supported language codes, please refer to: Google Language Codes.

Example Request:

Example results for q : pizza,hl: es

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "hl=es"

geo ,Location(Optional)

The parameter defines the location you wish to search from. It defaults to Worldwide (activated when the value of the geo parameter is not set or is empty). Go to Google Trends Locations for a complete list of supported Google Trends locations.

Example Request:

Example results for q : pizza,geo:India

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "geo=India"

region,Region(Optional)

The parameter is used to get more specific results when using the "By Region Comparison Segment" and "By Region by Interest"data_type charts. Other data_type charts do not accept the region parameter. The default value depends on the set geography. Available options:

COUNTRY - Country

REGION - Subregion

DMA - Metro

CITY - City

Example Request:

Example results for q : pizza,region:COUNTRY

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "region=COUNTRY"

Search Type

data_type ,data_type(Optional)

Parameter defines the type of search you want to do. Available options:

TIMESERIES - Interest over time - Accepts both single and multiple queries per search.

GEO_MAP - Compared breakdown by region - Accepts only multiple queries per search.

GEO_MAP_0 - Interest by region - Accepts only single query per search.

RELATED_TOPICS - Related topics - Accepts only single query per search.

RELATED_QUERIES - Related queries - Accepts only single query per search.

Example Request:

Example results for q : pizza,data_type:TIMESERIES

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "data_type=TIMESERIES"

Advanced Parameters

tz,Time Zone(Optional)

The parameter defines the time zone offset. The default value is 420 (Pacific Daylight Time (PDT): -07:00). The value is in minutes and ranges from -1439 to 1439. tz can be calculated using the difference between UTC+0 and the desired time zone. Example: -PDT

Example Request:

Example results for q : pizza,tz:-1439 to 1439

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "tz=-1439 to 1439"

cat,Category (Optional)

The parameter defines the search category. The default value is 0 (all categories).

Example Request:

Example results for q : pizza,cat:7

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "cat=7"

gprop ,Property(Optional)

Parameter is used for sorting results by property. The default property is set to Web Search (activated when the value of gprop parameter is not set or empty). Other available options:

images - Image Search

news - News Search

froogle - Google Shopping

youtube - YouTube Search

Code Example:

Example results for q : pizza,gprop:froogle

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "gprop=froogle"

date ,Date(Optional)

Parameter is used to define a date. Available options:

now 1-H- Past hour

now 4-H - Past 4 hours

now 1-d - Past day

now 7-d - Past 7 days

today 1-m - Past 30 days

today 3-m - Past 90 days

today 12-m - Past 12 months

today 5-y - Past 5 years

all - 2004 - present

You can also pass custom values:

Dates from 2004 to present: yyyy-mm-dd yyyy-mm-dd (e.g., 2021-10-15 2022-05-25)

Code Example:

Example results for q : pizza,date:now 1-H

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_trends" \
 -d "q=pizza" \
 -d "json=1" \
 -d "date=now 1-H"

For further assistance, contact us at [email protected].