Measures
Each measure is one path under/v1/measures/, answered by the endpoints below. Its price applies to every by split. GET /v1/measures lists available splits and measure prices for free. If anything on this page differs from the live OpenAPI spec or a 402 challenge, the live values are correct.
A split answered by a cheaper endpoint costs the measure’s price on the measure path.
prices by brand, for example, is $0.02 at /v1/measures/prices and $0.01 at /v1/marketing/price-positioning. The MCP tools call the endpoint directly, so they pay the endpoint’s price.
Endpoints by area
The per-endpoint routes are grouped by the kind of question they answer. The API Reference tab uses the same groups, except that the Taxonomy routes are under Reference and the two Scout routes are under Social. Each area has one price, so a call to any endpoint in it costs the same. Most callers do not need them: a measure reaches the same answers with one path and one pair of arguments.Prices by area
Shopper — $0.01 / query
Point-in-time pricing answers for shopping assistants and price-tracking tools.Marketing — $0.01 / query
Competitive intelligence for brand and category managers.Analyst — $0.02 / query
Aggregated, statistical, multi-product queries — more expensive because they touch more rows.Ontology — $0.01 / query
What a name means, what sits next to an id, and how much evidence stands behind it. Use the ids they return to scope the other endpoints.Taxonomy — $0.01 / request
GS1 GPC identity lookups, priced per request (up to 100 ids).Social — $0.03 / query
TikTok and Instagram. Most social routes are scoped to one Shopify taxonomy path: a root such asfood-beverages-tobacco or health-beauty, or any node under it (food-beverages-tobacco/beverages/soda). Retired browse roots such as grocery-gourmet-food are refused before payment, with the root to use instead. emerging-brands and product-names cover the whole tracked corpus and take no category, and tactics works with or without one. subject_kind on series is brand or category only. organic_only=true leaves out posts marked as ads.
Scout — $0.05 / query
These routes bind tracked social conversation and the observed retail shelf to a shared category axis. Their paths are under/v1/social/, not /v1/scout/, and the API Reference tab lists them under Social.
Why the gap between tiers?
Analyst answers aggregate across many products to produce statistical signals like price distributions and movers — they inform strategic, multi-product decisions. Shopper, Marketing, Ontology, and Taxonomy tiers serve lookup-style use cases. Social answers rank and compare activity across tracked TikTok and Instagram posts, so they are priced above Analyst. Scout combines that social data with the retail shelf data, so it is priced above Social. Send the unpaid request first: a social view that isn’t published yet is then refused with404 NOT_PUBLISHED before payment, so it is not billed. That is a gap in what we publish, not a finding that the category is quiet.