Yandex

SERP API Yandex Query Parameters

Configure Yandex search queries using Thordata's SERP API, including localization, geotargeting, and pagination options.

q ,Search Query(Required)

Defines the search query for scraping (default: q=pizza). Supports any keyword in any language.

Example Request:

Example with q:pizza parameter

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://yandex.com/search?text=pizza^&json=1\"}"

Localization

url ,Domain(Optional)

Specifies the Yandex domain to use (default: 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 https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://yandex.com.tr/search?text=pizza^&json=1\"}"
lang ,Language(Optional)

Controls interface language (default: en). Common values:

Example Request:

Example results for q : pizza,lang:en

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://yandex.com/search?text=pizza^&json=1^&lang=en\"}"

Geotargeting

lr ,Location(Optional)

Specifies result region (e.g., lr=Moscow), overriding IP-based location. Format: lr=<Region_Name> (e.g., lr=Moscow,Russia)

Example Request:

Example results for q : pizza,lr:India

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://yandex.com/search?text=pizza^&json=1^&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 https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://yandex.com/search?text=pizza^&json=1^&rstr=true\"}"

Pagination

p ,Page number(Optional)

Page control (starts at p=0). Combine with results-per-page parameters. Example: p=2 retrieves page 3 results.

Example Request:

Example results for q : pizza,p:2

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://yandex.com/search?text=pizza^&json=1^&p=2\"}"

Advanced Parameters

within ,Time period(Optional)

Time/domain restrictions:

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

  • Domain filter: within=example.com

Example Request:

Example results for q : pizza,within:2

curl https://scraperapi.thordata.com/request -H "Content-Type: application/json" -H "Authorization: Bearer Token" -d "{\"url\": \"https://yandex.com/search?text=pizza^&json=1^&within=2\"}"

For assistance, contact [email protected].

Last updated

Was this helpful?