# Bing News API

#### SERP API Bing Query Parameters

including output options for parameters such as localization, geographical location, and pagination.

<details>

<summary><strong><code>q</code> ,</strong>Search Query<strong>(Required)</strong></summary>

Parameter defines the search query. You can use anything that you would use in a regular Bing search.

**Example Request:**

Example with `q`:<mark style="color:blue;">pizza</mark> parameter

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing_news" \
 -d "q=pizza" \
 -d "json=1"
```

</details>

## Localization

<details>

<summary><strong><code>cc</code> ,</strong>Country<strong>(Optional)</strong></summary>

This parameter defines that during crawling, you can specify that search results be displayed according to the habits of users in a specific country/region. It is a two-letter country/region code (for example: `us`, `ru`, `uk`).

**Examples:**

* `cc=us` → United States (English)
* `cc=fr` → France (French)

**Example Request:**

Example results for `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_news" \
 -d "q=pizza" \
 -d "json=1" \
 -d "cc=jp"
```

</details>

<details>

<summary><code>setlang</code> <strong>,</strong>Language<strong>(Optional)</strong></summary>

This parameter defines the language to search in. It follows the format gb characters followed by ISO\_3166-1. (For example, United States, Germany, United Kingdom, etc.)

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,setlang:<mark style="color:blue;">eu</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_news" \
 -d "q=pizza" \
 -d "json=1" \
 -d "setlang=eu"
```

</details>

## Geographical Location

<details>

<summary><strong><code>mkt</code> ,</strong>Language<strong>(Optional)</strong></summary>

This parameter defines the interface display language of search results during crawling. It adopts the format of <"language code">-<"country/region code">.&#x20;

For example, `en-US`. This string is case-insensitive.

**Examples:**

* `mkt=en-US` → English (United States)
* `mkt=zh-CN` → Simplified Chinese

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`mkt`:<mark style="color:blue;">fr-fr</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_news" \
 -d "q=pizza" \
 -d "json=1" \
 -d "mkt=fr-fr"
```

</details>

## Pagination

<details>

<summary><strong><code>first</code> ,</strong>Result offset<strong>(Optional)</strong></summary>

Sets the result offset (default: `1`). For example, `first=10` skips the first 9 results.

This parameter is used to control the offset of Organic Search results, with a default value of 1. For example, when `first=10`, the system will promote the 10th organic search result to the top position.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`first`:<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_news" \
 -d "q=pizza" \
 -d "json=1" \
 -d "first=10" \
 -d "count=10"
```

</details>

<details>

<summary><strong><code>count</code> ,</strong>Results per page<strong>(Optional)</strong></summary>

Number of results per page (range: `1`–`50`). Use with `first` for pagination.

The per-page parameter is used to control the number of search results displayed per page (minimum value: 1, maximum value: 50). The actual effective value will be affected by the `first` offset parameter.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`count`:<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_news" \
 -d "q=pizza" \
 -d "json=1" \
 -d "first=10" \
 -d "count=10"
```

</details>

## Advanced Filters

<details>

<summary><code>qft</code><strong>,</strong>Sort by Date<strong>(Optional)</strong></summary>

This parameter defines whether adult content is blocked from search results. You can set it to either "`strict`" or "`off`".

Adult content filter:

* `strict` → Default (blocks adult content)
* `off` → Allows adult content

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`qft`:interval="8"

```sh
curl -X POST https://scraperapi.thordata.com/request \
 -H "Content-Type: application/x-www-form-urlencoded" \
 -H "Authorization: Bearer token" \
 -d "engine=bing_news" \
 -d "q=pizza" \
 -d "json=1" \
 -d "setlang=eu" \
 -d "qft=interval="8""
```

</details>

**For assistance, contact <support@thordata.com>.**
