> 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-hk/pa-qu/serp-api/cha-xun-can-shu/bing/bing-gou-wu-api.md).

# Bing 購物 API

**SERP API Bing查詢參數**

使用Thordata的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://scraperapi.thordata.com/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://scraperapi.thordata.com/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://scraperapi.thordata.com/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://scraperapi.thordata.com/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://scraperapi.thordata.com/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@thordata.com>** 聯繫我們。