> 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" ```
如需進一步幫助，請透過 **** 聯繫我們。 --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://doc.thordata.com/doc/zh/pa-qu/serp-api/cha-xun-can-shu/gu-ge/google-product.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.