API reference · Advertisers and companies

All ads of an advertiser (live or from history)

GET/v1/advertisers/{id}/ads

Example request

Shell

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

status

string

One of active, inactive, all

default all

source

string

history includes ads that vanished from the platform

One of live, history

default live

sort

string

source=history only: longest-running first

One of newest, days_running

default newest

cursor

string

–

limit

integer

default 25

Response

data.advertiserrequired

object

–

domain

string

–

id

string

name

string

–

platform_advertiser_id

string

–

verified

boolean

–

data.countriesrequired

string[]

ISO 3166-1 alpha-2

data.creativesrequired

object[]

–

cta

string

–

headline

string

–

landing_url

string

–

media

object[]

–

text

string

–

type

string

–

data.derivedrequired

object

–

days_running

integer

–

is_long_running

boolean

days_running > 30

language

string

ISO 639-1 of the primary ad text

variant_count

integer

Ads sharing this ad's primary text for the same advertiser

data.eu_datarequired

object

–

beneficiary

string

–

payer

string

–

reach_by_country

map of integer

–

reach_by_country_range

map of object

–

reach_range

object

–

reach_total

integer

–

targeting

object

–

data.extra

map of object

Platform-specific fields

data.first_seen_by_usrequired

datetime

–

data.first_shownrequired

datetime

–

data.formatsrequired

string[]

–

data.idrequired

string

Stable ID: <platform>:<platform_ad_id>

data.impressions_rangerequired

object

–

currency

string

–

lower

integer

–

upper

integer

–

data.last_seen_by_usrequired

datetime

–

data.last_shownrequired

datetime

–

data.library_url

string

–

data.placementsrequired

string[]

–

data.platformrequired

string

One of meta, google, tiktok, linkedin, pinterest, x

data.platform_ad_idrequired

string

–

data.politicalrequired

boolean

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

data.raw_ref

string

Pointer to the archived raw upstream record

data.spend_rangerequired

object

–

currency

string

–

lower

integer

–

upper

integer

–

data.statusrequired

string

One of active, inactive, unknown

metarequired

object

–

cached

boolean

–

count

integer

–

errors

object[]

Platforms that failed (not billed)

code

string

–

message

string

–

platform

string

–

platforms

string[]

–

source

string

One of live, history

next_cursorrequired

string

Pass as cursor to get the next page; null = last page