Skip to main content
GET
List Global Ad Library Advertisers

Authorizations

Authorization
string
header
required

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

Query Parameters

q
string | null
Required string length: 1 - 200
provider
string | null
Required string length: 1 - 80
platform
string | null
Required string length: 1 - 200
platform_facet
string | null
Required string length: 1 - 200
review_platform
enum<string> | null
Available options:
trustpilot,
google
has_reviews
boolean
default:false
sort
string | null
Required string length: 1 - 40
recommendation_industry
string | null
Required string length: 1 - 120
country
string | null
Required string length: 2 - 1000
language
string | null
Required string length: 2 - 1000
status
string | null
Required string length: 1 - 200
creative_type
string | null
Required string length: 1 - 200
video_length
string | null
Required string length: 1 - 200
industry
string | null
Required string length: 1 - 1000
brand_industry
string | null
Required string length: 1 - 1000
business_model
string | null
Required string length: 1 - 400
market
string | null
Required string length: 1 - 400
market_language
string | null
Required string length: 1 - 400
industry_source
string | null
Required string length: 1 - 200
has_landing_pages
boolean | null
theme
string | null
Required string length: 1 - 600
activity
string | null
Required string length: 1 - 200
seen_since
string<date-time> | null
seen_until
string<date-time> | null
limit
integer
default:50
Required range: x >= 1
offset
integer
default:0
Required range: x >= 0

Response

Successful Response

Paginated advertiser (brand) list for the Explore Brands tab.

total is the distinct advertiser count for the current filters (drives has_more / "Load more"); no brand scope — Explore browses the complete ad library.

platform_counts / any_platform_brand_count populate the "Platforms:" pill bar and are computed ONLY when the caller asks for them (platform_facet); an empty list means "not requested", never "zero brands". Both are computed with the caller's own platform filter REMOVED — a facet that narrows itself reports 0 for every option the user did not already pick, which reads as a broken control. Every other dimension (search, industry, business model, country, status, dates, review filters, tenancy) still applies, so the numbers move with the filter bar. any_platform_brand_count is the distinct brand count over the UNION of the requested platforms, not the sum of the rows: a brand advertising on Google and YouTube is one brand, and the rows deliberately do not add up to it.

generated_at
string<date-time>
required
limit
integer
required
offset
integer
required
total
integer
default:0
has_more
boolean
default:false
items
AdLibraryAdvertiserListItem · object[]
platform_counts
AdLibraryAdvertiserPlatformCount · object[]
any_platform_brand_count
integer
default:0