spt:), a GS1 product type (gpc:) and a brand (brand:). Resolve a name once, then pass the same id to a shelf route and to a social route. The two answers line up because they are about the same thing, not because two names happened to match.
The questions below were asked of the live API on 18 and 19 November 2026. The figures are from those answers. Prices are per call.
Is poppi’s buzz matched on the shelf, and where does it price?
1
Resolve the names ($0.01 each)
poppi resolves to the brand brand:b_623df28e754b27df. soda resolves to the Soda shelf, spt:fb-1-12 (338 listings from 53 brands at 46 retailers), and to the #soda hashtag.2
Set the conversation against the shelf ($0.05)
3
Place poppi on the soda shelf ($0.01)
4
Check whether the buzz is growing ($0.03)
Protein bars sit on two shelves. Who leads the shelf, and who gets talked about?
1
Resolve the name ($0.01)
spt:fb-2-17-2-4, 232 listings) and under health and beauty’s nutrition bars (spt:hb-1-9-1-3, 966 listings). It also returns the GS1 product type that covers both, gpc:10008059: 1,209 listings at 41 retailers. Social posts in the last 30 days: 12, of which 2 are on the snack shelf and 10 on the nutrition shelf.2
Count the shelf across both homes ($0.01)
3
Set the conversation against the nutrition shelf ($0.05)
window=90d, same price). The shelf drew 25 mentions. Barebells and Quest Nutrition, which hold 26% and 21% of this shelf’s products, drew 2 each. RXBAR, with 6% of the shelf, drew 5, and Perfect Bar, with under 1%, drew 4. 58 brands on the shelf drew none.The answer says one post moves a brand’s share by about 4 points here, and asks you not to call any brand a leader or a laggard of the conversation on this little data.The ids that join the two
Get them from
/v1/ontology/resolve (under Ontology in the API Reference tab). When a name fits several things, resolve returns all of them as equals. Pick the one the question means, or ask each.
With the MCP server, the same questions take the measure tools: measure_resolve, then measure_scout for social against shelf, measure_assortment for share of shelf, measure_prices by brand and measure_attention by week.