Why personas?
Different agents call this API for fundamentally different reasons. A shopping assistant wants the cheapest place to buy AirPods right now. A brand strategist wants to track promo cadence across competitors over the last quarter. An economist wants category-level inflation signals. A social scout wants who is talking about a shelf, and whether that attention matches distribution. Bundling endpoints by use case keeps the surface area legible.Tiers
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.Taxonomy — $0.01 / request
GS1 GPC identity lookups, priced per request (up to 100 ids).Social — $0.03 / query
TikTok and Instagram mention rankings, scoped to one browse category root (for examplegrocery-gourmet-food or beauty-personal-care). There is no subcategory filter and subject_kind is brand or category only. organic_only is a live filter. Aisle slugs such as beverages are not a social subcategory.
Scout — $0.05 / query
The only routes that bind social conversation and the retail shelf to one category axis.Why the gap between tiers?
Analyst answers aggregate across many products to produce statistical signals like inflation rates and price distributions — they inform strategic, multi-product decisions. Shopper, Marketing, and Taxonomy tiers serve lookup-style use cases. Social answers are ranked comparisons over a bought corpus (TikTok + Instagram), so they sit above Analyst. Scout binds both corpora, which is why it is priced above Social. Unpublished social rollups return404 NOT_PUBLISHED and are not billed. That is a gap in what we publish, not a finding that the category is quiet.