# Google Shopping

**SERP API 谷歌 Shopping 查詢參數**<br>

使用 Thordata 的 SERP API 配置谷歌 shopping 查詢，包括本地化參數、地理位置、分頁、以及「高級參數」輸出選項。

<details>

<summary><strong><code>q</code> ，搜索查詢（必填）</strong></summary>

定義用於數據抓取的搜索查詢（預設值：q=pizza）。支援任何語言的任意關鍵詞。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>參數的示例

```sh
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"
```

</details>

## 本土化

<details>

<summary><strong><code>google_domain</code>，域名(非必填)</strong></summary>

定義用於數據抓取的搜索引擎域名（預設值：google.com）。
\
您可在系統中修改此參數，或參考 Google 域名頁面獲取完整支援的域名列表。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`url` ：<mark style="color:blue;">google.co.ao</mark>參數的示例

```sh
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"
```

</details>

<details>

<summary><strong><code>gl</code> ，國家(非必填)</strong></summary>

指定搜尋結果的定位國家/地區（預設值：us）。採用兩位字母國家代碼（如：us-美國，ru-俄羅斯，uk-英國）。

完整國家代碼支援清單請參閱：[Google官方國家代碼表](https://developers.google.com/adwords/api/docs/appendix/geotargeting)

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`gl`<mark style="color:blue;">：ru</mark>參數的示例

```sh
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"
```

</details>

<details>

<summary><strong><code>hl</code> ，語言(非必填)</strong></summary>

設定搜尋結果的介面語言（預設值：en）。採用標準語言代碼格式（如：en-英文，es-西班牙文，zh-CN-簡體中文）。

完整語言代碼支援清單請參閱：[Google官方語言代碼表](https://developers.google.com/google-ads/api/docs/start)

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`hl`： <mark style="color:blue;">es</mark>參數的示例

```sh
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"
```

</details>

## 地理位置

<details>

<summary><strong><code>location</code>，地理位置(非必填)</strong></summary>

模擬從精確位置發起搜尋（需搭配 uule 參數使用）。若未指定此參數，系統可能採用代理伺服器的地理位置作為預設值。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`uule`:<mark style="color:blue;">w+CAIQICIFSW5kaWE</mark>參數的示例

```

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"
```

</details>

<details>

<summary><strong><code>uule</code> ，</strong>編碼位置<strong>(非必填)</strong></summary>

使用 Base64 編碼目標地理位置（需與 `location` 參數配合使用）。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`location`:<mark style="color:blue;">India</mark>,`uule`:<mark style="color:blue;">w+CAIQICIFSW5kaWE</mark>參數的示例

```sh
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"
```

</details>

## 分頁

<details>

<summary><strong><code>start</code> ，結果偏移量（非必填）</strong></summary>

此參數定義結果偏移量。它會跳過指定數量的結果。它用於分頁。 （例如，0（預設值）表示第一頁結果，10 表示第二頁結果，20 表示第三頁結果，以此類推。）

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`start`:<mark style="color:blue;">30</mark>參數的示例

```sh
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"
```

</details>

<details>

<summary><strong><code>num</code> ，每頁結果數（非必填）</strong></summary>

設定搜尋結果每頁返回數量（預設值：10）。例如：`num`=10 表示每頁返回10筆結果。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`num`:<mark style="color:blue;">20</mark>參數的示例

```sh
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"
```

</details>

## 高級參數

<details>

<summary><strong><code>tbs</code> ，高級搜索條件（非必填）</strong></summary>

時間/類型篩選參數（支援進階條件設定）：

1. 時間範圍篩選：
   * qdr:h → 過去1小時（例：tbs=qdr:h）
   * qdr:d → 過去24小時（例：tbs=qdr:d）
   * qdr:w → 過去1週（例：tbs=qdr:w）
   * qdr:m → 過去1個月（例：tbs=qdr:m）
   * qdr:y → 過去1年（例：tbs=qdr:y）
2. 內容類型篩選：
   * sur:f → 僅顯示圖片結果（例：tbs=sur:f）
   * sur:fc → 僅顯示彩色圖片
   * sur:fm → 僅顯示動態圖片（GIF等）
3. 複合條件組合：
   * 可疊加多個條件（例：tbs=qdr:w,sur:f → 過去1週內的圖片結果）

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`tbs`:<mark style="color:blue;">sur:f</mark>參數的示例

```sh
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"
```

</details>

<details>

<summary><code>shoprs</code> <strong>，過濾器ID（非必填）</strong></summary>

此參數用於設定搜尋篩選器的輔助 ID，以精確控制搜尋結果的篩選條件。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`shoprs`:<mark style="color:$primary;">shoprs\_1</mark>參數的示例

```sh
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"
```

</details>

<details>

<summary><code>min_price</code> <strong>，最低價格（非必填）</strong></summary>

設定搜尋結果的最低價格門檻（單位：當地貨幣），此設定將覆寫任何透過 `shoprs` 參數嵌入的價格篩選條件。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`min_price`:<mark style="color:blue;">10</mark>參數的示例

```sh
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"
```

</details>

<details>

<summary><code>max_price</code> <strong>，最高價格（非必填）</strong></summary>

強制設定搜尋結果的最高價格上限（單位：當地貨幣），此設定將優先覆蓋所有透過 `shoprs` 或其他參數設定的價格篩選條件。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`max_price`:<mark style="color:blue;">100</mark>參數的示例

```sh
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"
```

</details>

<details>

<summary><code>sort_by</code><strong>，排序依據（非必填）</strong></summary>

**功能說明**：定義搜尋結果的排序規則，特別針對商品價格進行排序優化。

**可用選項：**

| 值   | 排序方式       | 適用場景           |
| --- | ---------- | -------------- |
| `1` | **價格由低到高** | 比價採購、預算型消費     |
| `2` | **價格由高到低** | 奢侈品搜尋、高端商品市場分析 |

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`sort_by`: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_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "sort_by=1"
```

</details>

<details>

<summary><code>free_shipping</code><strong>，免費送貨（非必填）</strong></summary>

制篩選出提供免運費服務的商品，排除所有需支付運費的搜尋結果

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`free_shipping`:true參數的示例

```sh
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"
```

</details>

<details>

<summary><code>on_sale</code><strong>，特價中非必填）</strong></summary>

强制筛选出标有促销标识的商品（如折扣价/限时优惠/满减活动），排除所有常规价格商品

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`on_sale`:true參數的示例

```sh
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"
```

</details>

<details>

<summary><code>small_business</code><strong>，小型企業（非必填）</strong></summary>

進展示小型企業。

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`small_business`:true參數的示例

```sh
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"
```

</details>

<details>

<summary><code>direct_link</code><strong>，包括直接連接（非必填）</strong></summary>

控制搜尋結果是否包含商品的「直連購買連結」

**示例請求：**

使用`q`：<mark style="color:blue;">pizza</mark>,`direct_link`:true參數的示例

```sh
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"
```

</details>

如需進一步幫助，請透過 **<support@thordata.com>** 聯繫我們。


---

# Agent Instructions: 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:

```
GET https://doc.thordata.com/doc/zh-hk/pa-qu/serp-api/cha-xun-can-shu/gu-ge/google-shopping.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.