curl -X POST "https://api.adlibapi.com/v1/watchlists" \
-H "X-API-Key: $ADLIB_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domains":["nike.com","adidas.com"],"name":"Competitors","webhook_url":"https://hooks.example.com/adlib"}'API reference · Watchlists and webhooks
Watch brands by domain or single advertisers; we crawl them regularly and call your webhook on changes
/v1/watchlistsTry it with your accountOpens in your dashboard, filled in; you see the cost before it runs.
Example request
Send your key in the X-API-Key header. Try it in the explorer.
Request body
advertisersSingle advertiser ids <platform>:<id> (find them via /v1/advertisers/resolve). Each counts as one brand against the plan's limit
archive_videosKeep full video files for these advertisers (default true)
domainsBrand domains: we find the brand's accounts on every platform, watch them together and add new ones as they appear. Each domain counts as one brand against the plan's limit
email_alertsMail a digest of each crawl's changes (new, stopped, changed, removed ads) to your account's email. Accounts only, not admin keys
exclude_advertisersAccounts of these domains to leave out, now and when new accounts are looked for
include_advertisersAccounts to add to the brand although we are not sure they are its own (candidates of GET /v1/companies/{domain}). Needs exactly one domain
interval_hoursCrawl interval in hours (default 24). Shortest per plan: Free and Starter 24, Plus and Growth 12, Pro 6, Business 1
namewebhook_urlReceives advertiser.changes events (new/stopped/changed ads)
Response
data.advertiser_countrequireddata.advertisersrequiredEmpty in the list endpoint; GET /v1/watchlists/{id} has the entries
active_ads_knownadvertiser_idlast_crawl_atlast_errornamenext_crawl_atdata.archive_videosrequireddata.brandsrequiredBrand domains on this watchlist; each counts as one brand against the plan's limit, whatever its number of accounts
data.created_atrequireddata.email_alertsrequiredA digest of each crawl's changes goes to the account's email
data.idrequireddata.interval_hoursrequiredCrawl interval, as set with interval_hours on create
data.namerequireddata.webhook_urlrequired