New, stopped and changed ads since a point in time

GET/v1/advertisers/{id}/changes

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

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

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

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

metarequired

object

–

count

integer

–

summary

map of integer

–

next_cursorrequired

string

–