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 brands by domain or single 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 - PATCH
/v1/watchlists/{id}Change a watchlist's name, webhook or email alerts - POST
/v1/watchlists/{id}/advertisersAdd advertisers to a watchlist - DELETE
/v1/watchlists/{id}/advertisers/{advertiser_id}Remove an advertiser from a watchlist - POST
/v1/watchlists/{id}/brandsAdd brands to a watchlist by domain, with all their accounts - DELETE
/v1/watchlists/{id}/brands/{domain}Remove a brand and its accounts 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
Batch jobs
Platforms, status and usage
- GET
/public/coverageArchive size and freshness (public, cached 10 minutes) - GET
/public/showcaseArchived runs of selected advertisers for the website (public, cached an hour) - GET
/public/showcase/featuredFeatured ads with history and creative features for the website (public, cached 6 hours) - GET
/v1/erasuresTakedown feed: ads and advertisers deleted after a takedown or erasure request - GET
/v1/platformsSupported search modes and filters per platform - GET
/v1/statusPublic status: success rate and response times of API calls, state of each platform, 90 days - GET
/v1/usageYour billed units per day and endpoint