Google Shopping
SERP API Google Shopping Query Parameters
Configure Google Shopping queries using Thordata’s SERP API, including localization parameters, geotargeting, pagination, and "advanced parameter" output options.
q
,Search Query(Required)
Define the search query used for data crawling (default value: q=pizza
). Any keywords in any language are supported.
Example Request:
Example with q
:pizza parameter
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1"
Localization
google_domain
,Domain(Optional)
Defines the domain used for scraping. Default: google.com
.
Modify this or refer to the Google Domains page for a full list of supported domains.
Example Request:
Example results for q
: pizza ,google_domain
: google.co.ao
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "google_domain=google.co.ao" \
-d "json=1"
gl
,Country(Optional)
Specifies the country/region for localized search results (default: us
). Uses a two-letter country code (e.g., us
, ru
, uk
).
For supported codes, see Google’s Country List.
Example Request:
Example results for q
: pizza,gl
: ru
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ru" \
-d "json=1"
hl
,Language(Optional)
Sets the UI language for search results (default: en
). Uses a two-letter language code (e.g., en
, es
, zh-CN
).
Full list: 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_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "hl=es"
Geotargeting
location
,Location(Optional)
Simulates searches from a precise location. Must be paired with uule
. If omitted, the proxy’s location may be used.
Example Request:
Example results for q
: pizza,location
:India,uule
:w+CAIQICIFSW5kaWE
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
uule
,UULE(Optional)
Encodes the target location via Base64. Use with location
.
Example Request:
Example results for q
: pizza,location
:India,uule
:w+CAIQICIFSW5kaWE
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "location=India" \
-d "uule=w+CAIQICIFSW5kaWE"
Pagination
start
,Result offset(Optional)
Sets the starting result index (default: 0
).
Example Request:
Example results for q
: pizza,start
:30
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "start=30"
num
,Results per page(Optional)
Sets the number of results per page (default: 20
).
Example Request:
Example results for q
: pizza,num
:20
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "num=20"
Advanced Parameters
tbs
,Advanced Search Parameters(Optional)
Time/type filtering (supports complex conditions), such as tbs
=qdr:d qdr:d= contents within 24 hours tbs
=sur:f, for example, shows only images
Example Request:
Example results for q
: pizza,tbs
:sur:f
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "tbs=sur:f"
shoprs
,Search Filter ID(Optional)
The parameter defines the token that includes metadata about query and search filter(s). Providing q
parameter alongside the shoprs is not required.
Example Request:
Example results for q
: pizza,shoprs
:shoprs_1
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "shoprs=shoprs_1"
min_price
,最低价格(Optional)
The lower limit for the price range query. This parameter will override the corresponding filter embedded in the 'shoprs' parameter.
示例请求:
Example Request:
Example results for q
: pizza,min_price
:10
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "min_price=10"
max_price
,最高价格(Optional)
价格区间查询的上限。此参数会覆盖嵌入到 shoprs
参数中的相应过滤器。
示例请求:
查询 q
: pizza,max_price
:100的示例
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "min_price=10" \
-d "max_price=100"
sort_by
,排序依据(Optional)
参数定义结果的排序顺序。
可用选项:
1
- 价格:从低到高
2
- 价格:从高到低
示例请求:
查询 q
: pizza,sort_by
:1的示例
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "json=1" \
-d "sort_by=1"
free_shipping
,免费送货(Optional)
仅显示免费送货的商品。
示例请求:
查询 q
: pizza,free_shipping
:true的示例
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ad" \
-d "json=1" \
-d "free_shipping=true"
on_sale
,特价中(Optional)
仅显示正在促销的商品。
示例请求:
查询 q
: pizza,on_sale
:true的示例
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ad" \
-d "json=1" \
-d "on_sale=true"
small_business
,小型企业(Optional)
仅显示小型企业的产品。
示例请求:
查询 q
: pizza,small_business
:true的示例
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ad" \
-d "json=1" \
-d "small_business=true"
direct_link
,包括直接链接(Optional)
此参数确定搜索结果是否应包含每个产品的直接链接。默认情况下,它为 false
,如果您需要直接链接,请将其设置为 true
。
示例请求:
查询 q
: pizza,direct_link
:true的示例
curl -X POST https://scraperapi.thordata.com/request \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Authorization: Bearer token" \
-d "engine=google_shopping" \
-d "q=pizza" \
-d "gl=ad" \
-d "json=1" \
-d "direct_link=true"
For further assistance, contact us at [email protected].
Last updated
Was this helpful?