API reference
All endpoints of https://api.adlibapi.com. Authenticate with the X-API-Key header. The full spec is at /openapi.yaml (OpenAPI 3.1), and the explorer lets you send requests from the browser.
Advertisers and companies
- GET
/v1/advertisers/resolveFind a brand's advertiser ids on all platforms from its domain - GET
/v1/advertisers/resolve/reportsYour reports and how we resolved them - POST
/v1/advertisers/resolve/reportsReport a wrong or missing resolve match - GET
/v1/advertisers/{id}Get an advertiser incl. ad counts - GET
/v1/advertisers/{id}/adsAll ads of an advertiser (live or from history) - GET
/v1/advertisers/{id}/statsAdvertiser analytics from our history - GET
/v1/companies/{domain}Company profile: all ad accounts of a domain across platforms, with combined stats - GET
/v1/domains/suggestDomain suggestions from our index while typing - GET
/v1/domains/{domain}/checkIs this company advertising right now, and where?
Search
Ads
History
Watchlists and webhooks
- GET
/v1/watchlistsList your watchlists - POST
/v1/watchlistsWatch advertisers; we crawl them regularly and call your webhook on changes - DELETE
/v1/watchlists/{id}Delete a watchlist - GET
/v1/watchlists/{id}Get a watchlist with crawl status per advertiser - POST
/v1/watchlists/{id}/advertisersAdd advertisers to a watchlist - DELETE
/v1/watchlists/{id}/advertisers/{advertiser_id}Remove an advertiser from a watchlist - GET
/v1/webhooks/deliveriesYour webhook deliveries (newest first) - GET
/v1/webhooks/deliveries/{id}One delivery incl. its payload - POST
/v1/webhooks/deliveries/{id}/redeliverQueue a delivery again - GET
/v1/webhooks/secretYour webhook signing secret - POST
/v1/webhooks/secret/rotateRotate your webhook signing secret - POST
/v1/webhooks/testSend a signed test event (webhook.ping) to a URL