Yandex

SERP API Yandex Query Parameters

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

q (Required)

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

Code Example:

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

---

Localization

yandex_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:

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

hl (Optional)

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

• en (English)

• ru (Russian)

• es (Spanish) Full list: Yandex Language Codes

Example Request:

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

---

Geotargeting

lr (Optional)

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

Example Request:

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

rstr (Optional)

Dual filtering:

• Region lock: Forces results to match lr region

• Safe search: rstr=family blocks adult content

Example Request:

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

---

Pagination

p (Optional)

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

Example Request:

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

within (Optional)

Time/domain restrictions:

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

• Domain filter: within=example.com

Example Request:

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

---

For assistance, contact [e-mail].