Skip to main content
GET
Get Global Ad Library Advertiser

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

advertiser_id
string<uuid>
required

Response

Successful Response

id
string<uuid>
required
name
string
required
primary_domain
string | null
website_url
string | null
website_header_image_url
string | null
brand_classification
BrandClassification · object | null

A versioned multi-label brand classification.

Industries describe what the brand sells or does. Business models describe how it operates independently of industry. Keeping those dimensions separate prevents the historical E-Commerce pseudo-industry from replacing the brand's real product industry.

metadata
Metadata · object
viewer_is_admin
boolean
default:false
partners
AdLibraryPartnerSummary · object[]
last_top_ads_fetch_at
string<date-time> | null
source_accounts
AdLibrarySourceAccountSummary · object[]
ad_count
integer
default:0
ad_signals
AdLibraryAdSignals · object | null

Full-history rollups over ALL of an advertiser's stored ads.

Server-computed so the Full Brand Page shows true totals — the previous client-side derivation only saw the capped recent_ads window, which made "first ad seen" and every distribution chip wrong for any advertiser with more than one page of ads. Bucket semantics mirror the Explore surfaces: platforms uses the same Meta publisher-platform expansion as the pill counts, landing_domains the same domain normalization as the landing_domain filter.

eu_transparency
AdLibraryEuTransparency · object | null

Meta EU DSA transparency aggregated across an advertiser's ads.

Built from the per-ad aaa_info blocks (newest detail payload per ad). Only present when at least one of the advertiser's ads carries EU data; sampled is True when the payload scan hit its cap, meaning the totals cover a newest-first subset rather than every ad.

brand_profiles
AdLibraryBrandProfile · object[]
top_ads
AdLibrarySearchAd · object[]
recent_ads
AdLibrarySearchAd · object[]
provenance
Provenance · object