API reference · Advertisers and companies

Advertiser analytics from our history

GET/v1/advertisers/{id}/stats

Ads by status, format, country and language; run-time distribution; new ads per week; and the 5 longest-running ads (likely winners).

Example request

Shell

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

string

–

data.by_countryrequired

map of integer

Top 25 countries

data.by_formatrequired

map of integer

–

data.by_languagerequired

map of integer

–

data.by_statusrequired

map of integer

–

data.days_runningrequired

object

–

known

integer

Ads with a known start date

long_running

integer

Ads running longer than the long-running threshold

max

integer

–

median

number

–

p90

number

–

data.first_ad_atrequired

datetime

–

data.latest_ad_atrequired

datetime

–

data.longest_running_adsrequired

object[]

Top 5 by days_running — the advertiser's likely winners

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.new_ads_weeklyrequired

object[]

Ads first shown per ISO week, last 12 weeks

count

integer

–

week

string

–

data.political_adsrequired

integer

Ads the platform labels political or issue ads (Meta only)

data.total_adsrequired

integer

Ads in our history (incl. ads gone from the platform)