Creating a Task
Submit a Yandex SERP scraping task to retrieve organic search results for a given query.
Requires the serp scope on your API key.
Endpoint
POST /api/parsing/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 |
| takeScreenshot | boolean | no | Capture a screenshot of the SERP page (default: true) |
| isDesktop | boolean | no | Emulate desktop browser (default: false) |
| useragent | string | no | Custom User-Agent string (printable ASCII only) |
Example Request
curl https://app.scrapering.com/api/parsing/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