Skip to main content
Syntalic files every store listing and every social post against the same ids: a shelf (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)

poppi drew 17 of the 53 soda mentions in the last 30 days (32%) and has 35 of the shelf’s 336 products (10.4%). Pepsi and Sprite drew 9 and 8 mentions with 2 products each.The answer also says how far to trust this. With 53 mentions, one post moves a brand’s share by about 1.9 points, so the ranking is indicative only. Brands are joined on their id, never on their name: a brand that people post about but no tracked store sells is left out of the ranking, not guessed at.
3

Place poppi on the soda shelf ($0.01)

A poppi listing averages $26.25, against $30.28 for the shelf (price index 0.867, the mid tier). Per item it is $2.42, against $2.50 for the shelf (index 0.966). Packs differ in size, so the per-item figure is the fair comparison.
4

Check whether the buzz is growing ($0.03)

Weekly soda mentions of poppi ran at 1 to 3 a week from May to early October. They rose to 6 in the week of 19 October (104,738 views) and 6 again in the week of 9 November.
The answer. poppi drew about a third of the soda conversation this month while holding about a tenth of the soda products tracked, and it prices just under the shelf per item. Its mentions picked up from mid-October. The conversation is small, so treat the shares as a direction, not a measurement. Five calls, $0.11.

Protein bars sit on two shelves. Who leads the shelf, and who gets talked about?

1

Resolve the name ($0.01)

Two shelves come back as equals, because stores file protein bars in two places: under snack foods (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)

Counted as one product type, Barebells holds 22.4% of protein bar listings (271), Quest Nutrition 17.5% (211), BUILT 10.1%, RXBAR 8.8% and ALOHA 5.3%. Either shelf on its own would show only part of this.
3

Set the conversation against the nutrition shelf ($0.05)

Thirty days held only 10 mentions here, so this asks for 90 (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 answer. Barebells and Quest hold about 40% of protein bar listings across both shelves. Over 90 days they drew 4 of the nutrition shelf’s 25 mentions, and the rest spread across smaller brands such as RXBAR and Perfect Bar. Twenty-five mentions is too few to rank brands, so read this as a direction: so far, posts about protein bars do not track shelf share. Three calls, $0.07.

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.