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
2xxstatus 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
- Creating a task — back to the submit endpoint reference
- Receiving result — polling alternative to webhooks