API reference · History

New, stopped and changed ads since a point in time

GET/v1/advertisers/{id}/changes

Try it with your accountOpens in your dashboard, filled in; you see the cost before it runs.

Example request

Shell
curl "https://api.adlibapi.com/v1/advertisers/meta:15087023444/changes?since=2026-10-01" \
  -H "X-API-Key: $ADLIB_API_KEY"

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

Parameters

idrequired
path · string

e.g. meta:15087023444

sincerequired
string

YYYY-MM-DD or RFC3339

e.g. 2026-10-01

types
string

Comma-separated: started, stopped, changed, discovered, removed (the platform's library no longer shows the ad; we keep it)

default started,stopped,changed

cursor
string
–
limit
integer

default 50

Response

data.ad
object
–
advertiser
object
–
countries
string[]

ISO 3166-1 alpha-2

creatives
object[]
–
derived
object
–
eu_data
object
–
extra
map of object

Platform-specific fields

first_seen_by_us
datetime
–
first_shown
datetime
–
formats
string[]
–
id
string

Stable ID: <platform>:<platform_ad_id>

impressions_range
object
–
last_seen_by_us
datetime
–
last_shown
datetime
–
library_url
string
–
placements
string[]
–
platform
string

One of meta, google, tiktok, linkedin, pinterest, x, snapchat, apple, amazon, microsoft

platform_ad_id
string
–
political
boolean

Political or issue ad. Meta only; null where the platform doesn't label it

raw_ref
string

Pointer to the archived raw upstream record

removed_from_library_at
datetime

When the platform's library stopped showing this ad (taken down, deleted by the advertiser or past the library's retention). We keep it; null while the library still has it

spend_range
object
–
status
string

One of active, inactive, unknown

data.ad_id
string
–
data.atrequired
datetime
–
data.typerequired
string

One of started, stopped, changed, discovered, removed

metarequired
object
–
count
integer
–
summary
map of integer
–
next_cursorrequired
string
–