> For the complete documentation index, see [llms.txt](https://docs.talordata.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.talordata.com/cn-tw/serp-api/query-parameters/bing-serp-api/bing-shopping-api.md).

# Bing Shopping SERP API 參數指南

透過 Talordata SERP API，您可以配置 **Bing 購物**搜索查詢，包括本地化、地理位置以及進階參數等輸出選項。

<details>

<summary><strong><code>q</code> ，搜索查詢(必填)</strong></summary>

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

**示例請求：**

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

```sh
curl -X POST https://serpapi.talordata.net/serp/v1/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing_shopping" \
 -d "q=pizza" \
 -d "json=1"
```

</details>

## 本地化

<details>

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

此參數用於設定搜尋結果的地區化顯示（採用兩位字母國家代碼），例如：（`gl=us`：依美國用戶習慣顯示、`gl=ru`：依俄羅斯用戶習慣顯示`gl=uk`：依英國用戶習慣顯示）

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`cc`:<mark style="color:blue;">jp</mark>的示例結果

```sh
curl -X POST https://serpapi.talordata.net/serp/v1/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "cc=jp"
```

</details>

## 地理位置

<details>

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

此參數用於設定搜尋結果的介面顯示語言，採用標準語言代碼格式：

<語言代碼>-<國家代碼>（例如：`en-US`、`zh-TW`）

**示例請求：**

查询  `q` : <mark style="color:blue;">pizza</mark>,`mkt`:<mark style="color:blue;">fr-fr</mark>的示例

<pre class="language-sh"><code class="lang-sh"><strong>curl -X POST https://serpapi.talordata.net/serp/v1/request \
</strong> -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "mkt=fr-fr"
</code></pre>

</details>

## 分頁

<details>

<summary><code>efirst</code><strong>，結果偏移量(非必填)</strong></summary>

參數用於控制自然搜索結果的偏移量，默認值為1（例如：first=10時，系統會將第10條自然搜索結果提升至首位）。

**示例請求：**

查询 `q` : <mark style="color:blue;">pizza</mark>,`efirst`:<mark style="color:blue;">10</mark>的示例

```sh
curl -X POST https://serpapi.talordata.net/serp/v1/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "efirst=10"
```

</details>

## 高級篩選

<details>

<summary><code>filters</code><strong>，</strong>附加過濾<strong>(非必填)</strong></summary>

參數允許使用更複雜的過濾選項，例如按日期範圍過濾ex1:"ez5\_18169\_18230"或使用特定的顯示過濾器

（例如ufn:"Wunderman+Thompson"+sid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513"+catguid:"5bede9a2-1bda-9887-e6eb-30b1b8b6b513\_cfb02057"+segment:"generic.carousel"+entitysegment:"Organization"）

。可以使用 Bing 搜尋並複製filters查詢參數來建立精確值。

**示例請求：**

查询  `q` : <mark style="color:blue;">pizza</mark>,`filters`:ex1:"ez5\_18169\_18230"的示例

```sh
curl -X POST https://serpapi.talordata.net/serp/v1/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing_shopping" \
 -d "q=pizza" \
 -d "json=1" \
 -d "filters=ex1:"ez5_18169_18230""
```

</details>

如果您需要更多幫助，請隨時通過在線客服或 <support@talordata.com> 聯繫我們。