Yandex SERP Scraper

Creating a Yandex SERP Scraping Task

Submit a Yandex SERP scraping task to retrieve organic search results for a given query.

Requires the serp:yandex scope on your API key.

Endpoint

POST /api/parsing/v1/serp-yandex

Request Body

Name	Type	Required	Description
q	string	yes	Search query
count	number	yes	Number of results
region	number	no	Yandex region code (`lr` parameter) for geo-targeting (e.g. `202` for New York) — see Available cities
callbackUrl	string	no	Webhook URL to POST result when done

Example Request

curl https://app.scrapering.com/api/parsing/v1/serp-yandex \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --data '{
  "q": "buy pizza",
  "count": 10,
  "region": 202
}'

Example Response

{
  "id": "c1d2e3f4-a1b2-4c3d-8e9f-000111222333",
  "status": "parsing",
  "scope": "serp",
  "costCredits": 1,
  "createdAt": "2026-05-08T10:00:00.000Z"
}

The task is processed asynchronously. Use the id to poll for the result or set callbackUrl to receive a webhook when parsing completes.

Next steps

Receiving result — poll for the result using the task ID
Webhook — receive the result via callback instead of polling
Available cities — look up Yandex region codes (yandex_lr) for geo-targeting
Pricing — see how credits are calculated for SERP requests