GET /v1/watchlist/webhook

Your watchlist webhook and its recent deliveries

Get pushes instead of polling: set an https URL on your key and Poseidon POSTs the new changes of your watched brands (new ads, stopped ads, more versions, reused media, reach growth) about every hour, signed with HMAC-SHA256 (header Poseidon-Signature: t=…,v1=…; the secret is returned once when the URL is set), retried with backoff for about 15 hours. Each push costs what watchlist_changes costs (5 credits per brand with something new). Without arguments: shows the webhook and its recent deliveries. Free to set.

Cost: Free.

Parameters

No parameters.

Errors

401Missing, unknown or revoked API key.
429Too many requests for this key. Wait Retry-After seconds. Not billed.
503Server busy or a query took too long. Retry. Not billed.