> For the complete documentation index, see [llms.txt](https://doc.thordata.com/doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.thordata.com/doc/zh/pa-qu/serp-api/cha-xun-can-shu/gu-ge/google-product.md). # Google Product **SERP API Google 查询参数** \ 使用 Thordata 的 SERP API 配置 Google 搜索，包括本地化参数、地理定位、搜索类型、分页以及“高级筛选”输出选项。
product_id,产品ID(必填) 该参数用于定义要获取结果的商品，通常出现在支持商品展示的购物搜索结果中（例如：[https://www.google.com/shopping/product/{product\_id}](https://www.google.com/shopping/product/%7Bproduct_id%7D)）。 **示例请求：** 使用参数 `product_id` 的示例值：`4887235756540435899` ```sh 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` 的返回结果示例。 ```sh 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 国家/地区代码列表](https://developers.google.com/custom-search/docs/ref_country_codes) > * 若未指定或参数无效，系统将默认使用 `gl=us`（美国地区） **示例请求** ```sh 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 语言代码列表](https://developers.google.com/custom-search/docs/ref_language_codes) > * 若未指定或参数无效，系统将默认使用`hl=en`（英语界面） > * 语言代码区分大小写，请使用正确格式（如`zh-CN`而非`zh_cn`） **示例请求** 使用参数`product_id: 4887235756540435899` 及 `hl: es` 的示例結果。 ```sh 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 ,编码位置(非必填) 使用 Base64 编码目标地理位置，此参数必须与 `location` 参数配合使用。 **示例请求** 使用参数 `product_id`:4887235756540435899,`location`:India,`uule`:w+CAIQICIFSW5kaWE 的示例结果 ```sh 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 的示例结果 ```sh 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 的示例结果 ```sh 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 的示例结果 ```sh 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 ,结果位移量(非必填) 该参数定义结果偏移量。它会跳过指定数量的结果。它用于分页。（例如，0（默认值）表示第一页结果，10 表示第二页结果，20 表示第三页结果，以此类推。） **示例请求：** 使用参数 `product_id`: 4887235756540435899, `start`: 30 的示例结果 ```sh 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 的示例结果 ```sh 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` 的示例结果 ```sh 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` 的示例结果 ```sh 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" ```
如需進一步幫助，請透過 **** 聯繫我們。