Webhook

    Set callbackUrl in the submit request body to receive the result via webhook instead of polling. When parsing completes, the server sends a POST request to that URL with the result payload.

    Submit with Callback

    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,
      "callbackUrl": "https://my-server.com/webhook/parsing"
    }'
    

    Webhook Payload

    Make sure your webhook endpoint responds with a 2xx status code to acknowledge receipt.

    Your endpoint will receive a POST request with the following JSON body:

    {
      "status": "ready",
      "scope": "serp",
      "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"
    }
    

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

    Next steps