Receiving a Result

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

    Endpoint

    GET /api/parsing/result/serp/{requestId}

    Keep polling until status is no longer "parsing".

    Path Parameters

    NameTypeRequiredDescription
    requestIdstring (uuid)yesTask ID returned from the submit endpoint

    Example Request

    curl https://app.scrapering.com/api/parsing/result/serp/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

    FieldTypeDescription
    statusstring"ready" when complete
    requestIdstringTask ID
    data.organicarrayOrganic search results
    data.organic[].ranknumberPosition in results (1-based)
    data.organic[].linkstringResult URL
    data.organic[].titlestringResult title
    data.organic[].descriptionstringResult snippet
    respondedAtstringISO 8601 timestamp of completion

    Important! Screenshot is stored for 3 hours 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