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.

q ,Search Query(Required)

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

Example Request:

Example with q:pizza parameter

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"

Localization

yandex_domain ,Domain(Optional)

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 : pizza,url:yandex.com.tr

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"

lang ,Language(Optional)

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

Example Request:

Example results for q : pizza,lang:en

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"

Geographical Location

lr ,Location(Optional)

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 : pizza,lr:India

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"

rstr ,Location Strict Check(Optional)

Dual filtering:

• Region lock: Forces results to match lr region

• Safe search: rstr=family blocks adult content

Example Request:

Example results for q : pizza,rstr:true

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"

Pagination

p ,Page number(Optional)

Page control (starts at p=0).

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 : pizza,p:2

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"

Advanced Parameters

within ,Time period(Optional)

Time/domain restrictions:

• Time range: within=7d (Past 7 days)

• Domain filter: within=example.com

Example Request:

Example results for q : pizza,within:2

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"

For assistance, contact [email protected].