Skip to main content
GET
Get Leaderboards

Query Parameters

industry
string | null

An industry slug from the facets.

country
string | null

The market asked from: an ISO 3166-1 alpha-2 country, or europe for the board pooling the seven European countries. Omit it for Global.

Pattern: ^(?:[A-Z]{2}|europe)$
month
string | null

Publication month as YYYY-MM; omit for the latest.

side
enum<string>
default:all

AI and All use Heralded Scores and comparable history. Search keeps Google shares without a score or rank, and is empty where Google was not measured.

Available options:
all,
ai,
search
origin_country
string | null

Brand origin as an ISO country code.

Pattern: ^[A-Z]{2}$
order
enum<string>
default:default

Order by scores or podium places.

Available options:
default,
medals
q
string | null

Brand-name substring search.

Maximum string length: 200
audience
enum<string> | null

Filter brands by their audience.

Available options:
b2b,
b2c,
both
source_type

Filter by source category.

Available options:
industry_authority,
review,
regulatory,
media,
educational,
community,
consulting,
social,
vendor,
directory,
unclassified
include_brand_sites
boolean
default:false

Include brand sites in the source ranking and its total.

limit
integer
default:10

Maximum rows to return, up to 100.

Required range: 1 <= x <= 100
brands_offset
integer
default:0

Rows to skip in brands.

Required range: x >= 0
sources_offset
integer
default:0

Sources to skip.

Required range: x >= 0
source_pages_offset
integer
default:0

Rows to skip in source pages.

Required range: x >= 0
engines_offset
integer
default:0

Rows to skip in engines.

Required range: x >= 0
prompts_offset
integer
default:0

Related prompts to skip.

Required range: x >= 0
movers_offset
integer
default:0

Rows to skip in movers.

Required range: x >= 0
dropouts_offset
integer
default:0

Rows to skip in dropouts.

Required range: x >= 0

Response

Successful Response

brands
BrandsRead · object
required
dropouts
RankChangesRead · object
required
engines
EnginesRead · object
required
filters
LeaderboardFilters · object
required
leader
string<uuid> | null
required
meta
Meta · object
required

Normalized query and newest included scan.

month
string | null
required
months
string[]
required
movers
Movers · object
required
origin_counts
Origin Counts · object
required
population
integer | null
required
previous_month
string | null
required
prompts
PromptsRead · object
required
ranked
boolean
required
sources
SourcesRead · object
required