API reference · Advertisers and companies

Company profile: all ad accounts of a domain across platforms, with combined stats

GET/v1/companies/{domain}

Resolves the domain (like /v1/advertisers/resolve, including our manual corrections), keeps accounts with score >= min_score and aggregates their history: totals, platforms, countries, formats, weekly launches and the longest-running ads. Accounts of agencies, resellers and partners that run ads for the domain are listed separately under related (role per account) and left out of the totals unless include_related=true. Accounts below the threshold are listed as candidates. Costs one resolve plus one stats call.

Example request

Shell

curl "https://api.adlibapi.com/v1/companies/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

path · string

e.g. audi.de

platform

string

Comma-separated platforms; omit for all

min_score

number

Accounts below this resolve score are candidates, not part of the totals

default 0.75

max_per_platform

integer

Brands often run several accounts per platform (countries, product lines)

default 5

include_related

boolean

Count agency, reseller and partner accounts in platforms and stats too

Response

data.accountsrequired

object[]

The company's own accounts (role brand or unknown)

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

object[]

Possible accounts below min_score; report wrong ones via POST /v1/advertisers/resolve/reports

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

–

data.family

object

The parent company and its other brands, when known (reviewed by us); resolve a brand's domain for its accounts

brands

object[]

–

parent

string

–

parent_domain

string

–

data.namerequired

string

Name of the most confident account named like the brand (else the most confident one)

data.platformsrequired

object[]

–

accounts

integer

–

active_ads

integer

–

platform

string

–

total_ads_known

integer

–

data.relatedrequired

object[]

Agencies, resellers and partners running ads for the domain (role agency, reseller, partner)

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

object

Combined history of the accounts (plus related with include_related; advertiser_id is the domain)

advertiser_id

string

–

by_country

map of integer

Top 25 countries

by_format

map of integer

–

by_language

map of integer

–

by_status

map of integer

–

days_running

object

–

first_ad_at

datetime

–

latest_ad_at

datetime

–

longest_running_ads

object[]

Top 5 by days_running — the advertiser's likely winners

new_ads_weekly

object[]

Ads first shown per ISO week, last 12 weeks

political_ads

integer

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

total_ads

integer

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