API reference · Advertisers and companies

Find a brand's advertiser ids on all platforms from its domain

GET/v1/advertisers/resolve

Domain in, advertiser ids on Meta, Google, TikTok, LinkedIn, Pinterest and X out — each with a confidence score and match_reason.

Example request

Shell

curl "https://api.adlibapi.com/v1/advertisers/resolve?domain=nike.com" \
  -H "X-API-Key: $ADLIB_API_KEY"

Send your key in the X-API-Key header. Try it in the explorer.

Parameters

domainrequired

string

e.g. nike.com

platform

string

Comma-separated platforms; omit for all

max_per_platform

integer

default 3

Response

data.advertisersrequired

object[]

–

active_ads

integer

As reported by the platform if available, else counted by us

avatar_url

string

–

country

string

–

domain

string

–

extra

map of object

–

first_seen_by_us

datetime

–

id

string

–

last_seen_by_us

datetime

–

match_reason

string

manual = confirmed by us (or from a customer report we accepted)

One of domain, name, history, manual

name

string

–

platform

string

–

platform_advertiser_id

string

–

profile_url

string

–

role

string

The account's relation to the domain: the brand itself, or an agency, reseller (dealer, importer) or partner running ads for it

One of brand, agency, reseller, partner, unknown

role_source

string

manual = set by us; inferred = from the account name

One of manual, inferred

score

number

0..1 confidence that this advertiser belongs to the domain

total_ads_known

integer

Ads in our history

verified

boolean

–

data.domainrequired

string

–

data.errors

object[]

–

code

string

–

message

string

–

platform

string

–