Skip to main content
GET
Measure how concentrated a category is

Query Parameters

category
string
required

Product category. Accepts a human-readable name (e.g. 'electronics', 'beauty') or a taxonomy slug path (e.g. 'electronics/headphones'); matched against the catalog's category tree (exact node, subtree, or path substring). Also accepts a GS1 GPC code (exactly 8 digits, e.g. '10001159') to filter by PRODUCT TYPE instead of by shelf placement — the same product type is shelved under different categories by different retailers, so a category filter answers from a fraction of the data while a GPC code spans them. Coarser codes (class/family/segment) match every brick beneath them. Resolve a phrase to a code with /v1/reference/classify?q=... ; when a code is used, resolved.match_source is 'gpc'.

Minimum string length: 1
country
enum<string>
default:us

Country (us or ca)

Available options:
us,
ca

Response

Category concentration

category
string
country
string
hhi
integer | null
cr4
number | null
effective_brands
number | null
fragmentation
string | null
brand_count
integer
top_shares
object[]
coverage
object

How much data backed this answer. sufficient is false when the slice is too thin to read as a market statement; the count is always reported so you can judge for yourself, and note explains an empty or thin result rather than leaving you to infer it.

freshness
object

How current the underlying observations are. observedThrough is the newest observation behind this answer; staleHours is its age. Both null when nothing was observed.

quality
object | null
resolved
object
meta
object