curl "https://api.adlibapi.com/v1/advertisers/meta:15087023444/changes?since=2026-10-01" \
-H "X-API-Key: $ADLIB_API_KEY"API reference · History
New, stopped and changed ads since a point in time
/v1/advertisers/{id}/changesTry 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.
Parameters
idrequirede.g. meta:15087023444
sincerequiredYYYY-MM-DD or RFC3339
e.g. 2026-10-01
typesComma-separated: started, stopped, changed, discovered, removed (the platform's library no longer shows the ad; we keep it)
default started,stopped,changed
cursorlimitdefault 50
Response
data.adadvertisercountriesISO 3166-1 alpha-2
creativesderivedeu_dataextraPlatform-specific fields
first_seen_by_usfirst_shownformatsidStable ID: <platform>:<platform_ad_id>
impressions_rangelast_seen_by_uslast_shownlibrary_urlplacementsplatformOne of meta, google, tiktok, linkedin, pinterest, x, snapchat, apple, amazon, microsoft
platform_ad_idpoliticalPolitical or issue ad. Meta only; null where the platform doesn't label it
raw_refPointer to the archived raw upstream record
removed_from_library_atWhen 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_rangestatusOne of active, inactive, unknown
data.ad_iddata.atrequireddata.typerequiredOne of started, stopped, changed, discovered, removed
metarequiredcountsummarynext_cursorrequired