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/google \
      --request POST \
      --header 'Content-Type: application/json' \
      --header 'Authorization: Bearer YOUR_API_KEY' \
      --data '{
      "q": "Buy pizza",
      "pages": 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": "abaf4ac3-d9e7-43f2-a414-e7d2ca9ff635",
      "data": {
        "input": {
          "original_url": "https://www.google.com/search?q=Buy+pizza&hl=en&gl=us"
        },
        "organic": [
          {
            "link": "https://example.com/pizza",
            "rank": 1,
            "title": "Order Pizza Online",
            "description": "Fast delivery. Order now at example.com."
          }
        ],
        "related": []
      },
      "respondedAt": "2026-03-20T10:35:35.866Z"
    }
    

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

    Next steps