API reference · Watchlists and webhooks

Watch advertisers; we crawl them regularly and call your webhook on changes

POST/v1/watchlists

Example request

Shell

curl -X POST "https://api.adlibapi.com/v1/watchlists" \
  -H "X-API-Key: $ADLIB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"advertisers":["meta:15087023444","google:AR18378488041124659201"],"name":"Competitors","webhook_url":"https://hooks.example.com/adlib"}'

Send your key in the X-API-Key header. Try it in the explorer.

Request body

advertisersrequired

string[]

Advertiser ids <platform>:<id> (find them via /v1/advertisers/resolve)

archive_videos

boolean

Keep full video files for these advertisers (default true)

interval_hours

integer

Crawl interval in hours (default 24). Shortest per plan: Free and Starter 24, Growth 12, Pro 6, Business 1

name

string

–

webhook_url

string

Receives advertiser.changes events (new/stopped/changed ads)

Response

data.advertiser_countrequired

integer

–

data.advertisersrequired

object[]

Empty in the list endpoint; GET /v1/watchlists/{id} has the entries

active_ads_known

integer

–

advertiser_id

string

–

last_crawl_at

datetime

–

last_error

string

–

name

string

–

next_crawl_at

datetime

–

data.archive_videosrequired

boolean

–

data.created_atrequired

datetime

–

data.idrequired

string

–

data.interval_hoursrequired

integer

Crawl interval, as set with interval_hours on create

data.namerequired

string

–

data.webhook_urlrequired

string

–