# 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>** 聯繫我們。


---

# 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/bing/bing-gou-wu-api.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.