Skip to main content
GET
List brands in the catalog

Query Parameters

q
string

Prefix match on the normalized brand key (case/punctuation-insensitive)

Minimum string length: 1
tier
enum<string>
default:all

Only list brands of this tier. Unset or all lists every brand. How deep the brand is listed: a fact about the listings we hold, not a verdict on the brand. established = two or more served listings (counted at the grain of product_count); long_tail = exactly one. A real brand with one listing is long_tail until it has a second, and the tier can change between publishes. Variants and countries are separate listings, so a one-product Shopify store with variants, or a marketplace label with two ASINs or two countries, is established: the tier is listing depth, not storefront versus brand. More values may be added later, so do not treat the set as closed. An unknown value is a 400.

Available options:
all,
established,
long_tail
limit
integer
default:100

Max results to return (default 100, min 1, max 500)

Required range: 1 <= x <= 500
offset
integer
default:0

Pagination offset

Required range: x >= 0

Response

Public brands

items
object[]
total
integer

How many brands match q (and tier, when one is given). Which tier it counts is total_tier: with no tier parameter it counts every brand, the long tail included.

total_tier
enum<string>

Which brands total counts: all (no tier parameter, or tier=all), or the one tier that was asked for.

Available options:
all,
established,
long_tail
limit
integer
offset
integer
grain
enum<string>

What every item's product_count counts: retailer listings (product_uid), not unique products.

Available options:
listing