Skip to content

Webhooks

Today the API is poll-only: submit a task, then poll GET /serp/tasks/{id} until it’s done. See Task lifecycle.

Result webhooks — a callback URL we POST when a task finishes, so you can skip polling entirely — are on the roadmap. When they ship you’ll be able to pass a callback_url at submit time and receive a signed payload on completion.

Until then, poll with sensible backoff. If you have a strong need for push delivery, let us know from your dashboard — it helps us prioritize.