API reference
Webhooks
Receive completed runs and alert events without polling.
Supply a webhook_url on a run, or register a project-level endpoint to receive every event. We sign each delivery with an HMAC-SHA256 signature over the raw body.
X-Nostimates-Event: run.completed
X-Nostimates-Signature: sha256=…
X-Nostimates-Delivery: whd_1f8c…Events
| event | fires when |
|---|---|
| run.completed | all requested surfaces finished collecting |
| run.failed | extraction fell below the success threshold |
| alert.share_shift | a tracked brand's citation share moved beyond its interval |
| alert.new_competitor | an untracked brand entered the cited set |
| parser.degraded | canaries detected schema drift on a surface |
Verify before you trust
Always verify the signature before processing. Deliveries retry up to ten times over five minutes on any non-2xx response.