All observed versions and status changes of an ad

GET/v1/ads/{id}/history

Example request

Shell

curl "https://api.adlibapi.com/v1/ads/meta:1187430977361020/history" \
  -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:1234567890

Response

data.ad_idrequired

string

–

data.eventsrequired

object[]

–

ad

object

–

ad_id

string

–

at

datetime

–

type

string

One of started, stopped, changed, discovered

data.reachrequired

object[]

EU reach per day (Meta ads delivered in the EU), oldest first. The growth between points shows how strongly an ad is pushed.

day

string

–

reach_by_country

map of integer

–

reach_total

integer

–

data.status_periodsrequired

object[]

–

active_from

datetime

–

active_to

datetime

–

data.versionsrequired

object[]

–

creatives

object[]

–

valid_from

datetime

–

valid_to

datetime

–