# Yandex

#### SERP API Yandex Query Parameters

Configure Yandex search queries using Thordata's SERP API, 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>

Define the search query for data crawling (default value: q=pizza). Any keywords in any language are supported.

**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=yandex" \
 -d "text=pizza" \
 -d "json=1"
```

</details>

## Localization

<details>

<summary><code>yandex_domain</code> <strong>,</strong>Domain<strong>(Optional)</strong></summary>

This parameter defines the domain name used for crawling, with a default value:`yandex.com`.\
**Available options:**

* `yandex.com`
* `yandex.ru`
* `yandex.com.tr`\
  (Other regional domains supported)

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`url`:<mark style="color:blue;">yandex.com.tr</mark>

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

</details>

<details>

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

This parameter defines the language used for search results during crawling, with a default value of "`en`". It is a two-letter language code (for example, `en`, `ru`, `es`).\
**Common values:**

* `en` (English)
* `ru` (Russian)
* `es` (Spanish)\
  Full list: [Yandex Language Codes](https://yandex.com/support/search/query-language.html)

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`lang`:<mark style="color:blue;">en</mark>

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

</details>

## Geographical Location

<details>

<summary><strong><code>lr</code> ,</strong>Location<strong>(Optional)</strong></summary>

Specify the region for search results (e.g., `lr=Moscow,Russia` displays only results from Moscow), which takes priority over IP-based geolocation.

\
Format: `lr=<Region_Name>` (e.g., `lr=Moscow,Russia`)

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`lr`:<mark style="color:blue;">India</mark>

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

</details>

<details>

<summary><strong><code>rstr</code> ,</strong>Location Strict Check<strong>(Optional)</strong></summary>

Dual filtering:

* Region lock: Forces results to match `lr` region
* Safe search: `rstr=family` blocks adult content

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`rstr`:<mark style="color:blue;">true</mark>

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

</details>

## Pagination

<details>

<summary><strong><code>p</code> ,</strong>Page number<strong>(Optional)</strong></summary>

Page control (starts at `p=0`).&#x20;

It needs to be used in conjunction with the parameter for the number of items per page.

Example: `p`=2 retrieves results from the 3rd page.

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`p`:<mark style="color:blue;">2</mark>

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

</details>

## Advanced Parameters

<details>

<summary><strong><code>within</code> ,</strong>Time period<strong>(Optional)</strong></summary>

Time/domain restrictions:

* Time range: `within=7d` (Past 7 days)
* Domain filter: `within=example.com`

**Example Request:**

Example results for `q` : <mark style="color:blue;">pizza</mark>,`within`:<mark style="color:blue;">2</mark>

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

</details>

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