Skip to main content
GET
Analyze a brand's price positioning vs competitors

Query Parameters

brand
string
required

Brand name (e.g., Sony, Samsung, Nike)

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

Country (us or ca)

Available options:
us,
ca
category
string

Product category in the Shopify product taxonomy. Accepts a display path (e.g. 'Electronics > Computers > Laptops'), its slug form (e.g. 'electronics/computers/laptops'), a single path segment (e.g. 'laptops', 'headphones'), or an everyday shelf name (e.g. 'apparel', 'beauty', 'grocery'); matched against the catalog's category tree (exact node, subtree, or whole path segment). 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
retailer
enum<string>

Filter to a specific retailer platform (long-tail specialty stores are also present; any platform key is accepted)

Available options:
amazon,
walmart,
target,
bestbuy,
homedepot,
costco,
ikea,
samsclub,
cvs,
dillards

Response

Price positioning data

brand
string
category
string
country
string
currency
string
brand_avg_price
number | null
category_avg_price
number | null
category_median_price
number | null
price_index
number | null
positioning
enum<string>
deprecated

Ratio of averages. Prefer tier.

Available options:
premium,
mid-range,
value,
unknown
brand_median_price
number | null
tier
enum<string> | null

The brand's median on the shelf's equal-population ladder.

Available options:
entry,
value,
mid,
premium,
luxury
tier_node
string | null

The category node whose price band the tier was read from.

tier_edges
number[]

The ladder's ascending tier upper bounds. Empty when there is no band.

banded_from
string | null

Set when the ladder's shape was inherited from an ancestor shelf.

product_count
integer
resolved
object
meta
object