Yandex SERP Scraper

Receiving Yandex SERP Results

Poll this endpoint to retrieve the result of a submitted Yandex SERP scraping task.

Endpoint

GET /api/parsing/v1/result/serp-yandex/{requestId}

Keep polling until status is no longer "parsing".

Path Parameters

Name	Type	Required	Description
requestId	string (uuid)	yes	Task ID returned from the submit endpoint

Example Request

curl https://app.scrapering.com/api/parsing/v1/result/serp-yandex/YOUR_REQUEST_ID \
  --header 'Authorization: Bearer YOUR_API_KEY'

Responses

In progress — task is still being processed:

{
  "status": "parsing"
}

Ready — task completed successfully:

{
  "status": "ready",
  "requestId": "c1d2e3f4-a1b2-4c3d-8e9f-000111222333",
  "data": {
    "organic": [
      {
        "link": "https://pizza.ru/",
        "rank": 1,
        "title": "Pizza - Order Online",
        "description": "Fast pizza delivery across the city."
      }
    ]
  },
  "respondedAt": "2026-05-08T10:00:06.000Z"
}

Response Fields

Field	Type	Description
status	string	`"ready"` when complete
requestId	string	Task ID
data.organic	array	Organic search results
data.organic[].rank	number	Position in results (1-based)
data.organic[].link	string	Result URL
data.organic[].title	string	Result title
data.organic[].description	string	Result snippet
respondedAt	string	ISO 8601 timestamp of completion

Important! Screenshot is stored for 1 hour after the scrape.
Save the results on your side so you don't lose them.

Next steps

Webhook — receive the result via callback instead of polling
Creating a task — back to the submit endpoint reference