Google Product

SERP API Google 查询参数 使用 Thordata 的 SERP API 配置 Google 搜索，包括本地化参数、地理定位、搜索类型、分页以及“高级筛选”输出选项。

product_id,产品ID(必填)

该参数用于定义要获取结果的商品，通常出现在支持商品展示的购物搜索结果中（例如：https://www.google.com/shopping/product/{product_id}）。

示例请求：

使用参数 product_id 的示例值：4887235756540435899

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

本地化

google_domain,域名(非必填)

定义用于数据抓取的搜索引擎域名（默认值：google.com）。

示例请求：

使用参数 product_id: 4887235756540435899 和 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_product" \
 -d "product_id=4887235756540435899" \
 -d "google_domain=google.co.ao" \
 -d "json=1"
gl ,国家(非必填)

此参数用于设定搜索结果的属地化返回，需使用两位字母的国家代码（例如：us表示美国、ru表示俄罗斯、uk表示英国）。

  • 完整支持的国家代码列表请参考官方文档：Google 国家/地区代码列表

  • 若未指定或参数无效，系统将默认使用 gl=us（美国地区）

示例请求

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_product" \
 -d "product_id=4887235756540435899" \
 -d "gl=ru" \
 -d "json=1"
hl ,语言(非必填)

此参数用于控制搜索结果的显示语言，需使用标准语言代码格式（例如：en表示英语、es表示西班牙语、zh-CN表示简体中文）。

  • 完整的支持语言代码列表请参阅官方文档：Google 语言代码列表

  • 若未指定或参数无效，系统将默认使用hl=en（英语界面）

  • 语言代码区分大小写，请使用正确格式（如zh-CN而非zh_cn）

示例请求

使用参数product_id: 4887235756540435899 及 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_product" \
 -d "product_id=4887235756540435899" \
 -d "json=1" \
 -d "hl=es"

地理位置

location ,位置(非必填)

此参数用于指定搜索请求的地理位置，必须与 uule 参数配合使用。若未提供，系统可能默认采用代理服务器的物理位置。

  • location：可读的地理位置名称（如"India"），仅用于标识

  • uule：Google 专用的位置编码字符串（需通过算法生成）

  • 两者需同时传入以确保精确定位

示例请求

使用参数 product_id:4887235756540435899,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_product" \
 -d "product_id=4887235756540435899" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"
uule ,UULE(非必填)

使用 Base64 编码目标地理位置，此参数必须与 location 参数配合使用。

示例请求

使用参数 product_id:4887235756540435899,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_product" \
 -d "product_id=4887235756540435899" \
 -d "json=1" \
 -d "location=India" \
 -d "uule=w+CAIQICIFSW5kaWE"

搜索类型

offers ,最后结果(非必填)

获取优惠结果的参数设置（取代先前的 seller=online 结果）。可设置为 1 或 true。 注意：offers 参数不可与 offer_id 参数同时使用。

示例请求：

使用参数 product_id: 4887235756540435899, offers: 1 的示例结果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_product" \
 -d "product_id=4887235756540435899" \
 -d "json=1" \
 -d "offers=1"
specs ,取得规格结果(非必填)

用于获取规格结果的参数设置。可设置为 1 或 true。 注意：specs 参数不可与 offer_id 参数同时使用。

示例请求：

使用参数 product_id: 4887235756540435899, specs: 1 的示例结果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_product" \
 -d "product_id=4887235756540435899" \
 -d "json=1" \
 -d "specs=1"
reviews ,取得评论结果(非必填)

用于获取评论结果的参数设置。可设置为 1 或 true。 请注意：reviews 参数不可与 offer_id 参数同时使用。

示例请求：

使用参数 product_id: 4887235756540435899, reviews: 1 的示例结果

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

分页

start ,结果位移量(非必填)

设置搜索结果分页的起始点（例如："start=30" 表示跳过前30条结果，从第31条结果开始显示）。

示例请求：

使用参数 product_id: 4887235756540435899, 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_product" \
 -d "product_id=4887235756540435899" \
 -d "json=1" \
 -d "start=30"
page ,从页面开始(非必填)

用于定义 Google 线上商家页面编号的参数（每页显示 10 条结果）。该参数等同于 start（偏移量）= 页码 * 10。 注意：仅在启用 offers 参数时可用此功能。

示例请求：

使用参数 product_id: 4887235756540435899, page: 20 的示例结果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_product" \
 -d "product_id=4887235756540435899" \
 -d "json=1" \
 -d "page=20"

高級篩選

filter ,搜索参数(非必填)

用于设置评论与优惠结果的筛选条件、排序方式及分页配置。

优惠筛选条件：

  • freeship:1 - 仅显示免运费商品

  • ucond:1 - 仅显示二手商品

  • scoring:p - 按基础价格排序

  • scoring:tp - 按总价排序

  • scoring:cpd - 按当前促销优惠排序

  • scoring:mrd - 按卖家评分排序

示例请求：

使用参数 product_id: 4887235756540435899, filter:ucond:1 的示例结果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_product" \
 -d "product_id=4887235756540435899" \
 -d "filter=ucond:1" \
 -d "json=1"
offer_id,优惠ID(非必填)

用于定义从线上商家获取多个优惠ID的参数（该ID可在 sellers_results.online_sellers 中找到）。

注意：

  • offer_id 参数不可与 offers、specifications 及 reviews 参数同时使用

示例请求：

使用参数 product_id: 4887235756540435899, offer_id:detali 的示例结果

curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=google_product" \
 -d "product_id=4887235756540435899" \
 -d "json=1" \
 -d "offer_id=detali"

如需進一步幫助，請透過 [email protected] 聯繫我們。

PreviousGoogle NewsNextGoogle Images

Last updated

Was this helpful?