{"uid":"cap_Fv76tjl9sWbYgvqKBS5ne","slug":"syntalic-attention-vs-shelf-b7acc2d2","name":"Syntalic Attention vs Shelf","description":"Social signals query - $0.03 per request","url":"https://api.syntalic.com/v1/social/attention-vs-shelf","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","required":["category"],"properties":{"limit":{"type":"integer","default":25,"maximum":100,"minimum":1,"description":"Maximum ranked brands to return."},"window":{"enum":["7d","30d","90d"],"type":"string","default":"30d","description":"Rollup window. Only published windows are accepted."},"country":{"enum":["us","ca"],"type":"string","default":"us","description":"Country for the SHELF side of the join."},"category":{"type":"string","example":"grocery-gourmet-food","description":"Category root slug. No wildcard: these answers are ranked comparisons."},"platform":{"enum":["all","tiktok","instagram"],"type":"string","default":"all","description":"TikTok and Instagram are the only platforms in the corpus."},"organic_only":{"type":"boolean","default":false,"description":"Exclude posts marked as ads."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.03/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.03","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dO5ydx4lbWOCtzCEd2LmA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.03","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Compares social media attention (TikTok/Instagram signals) against retail shelf presence for brands within a product category, ranked by engagement metrics.","exampleAgentPrompt":"Which brands in the grocery-gourmet-food category are getting the most TikTok and Instagram buzz relative to their shelf presence right now? Give me the top 25 brands, using the last 30 days of data for the US market.","exampleUseCases":[{"title":"Spot emerging challenger brands","prompt":"Which brands in the beauty category are blowing up on TikTok and Instagram right now but still have low shelf presence in the US? Show me the top 20 over the last 30 days — I want to find the ones punching above their weight on social."},{"title":"CPG brand portfolio review","prompt":"I need to see how our snack brands stack up — pull the attention vs shelf ranking for the snacks category in Canada over the past 90 days, organic posts only, top 50 brands."},{"title":"Retail buyer category analysis","prompt":"For my category review meeting, can you pull the social attention vs shelf comparison for the pet-food category in the US over the last 7 days, using all platforms, top 25 brands?"}],"resultDescription":"A ranked list of brands within the specified category, each with a social attention score derived from TikTok and/or Instagram engagement and a corresponding retail shelf presence metric, allowing comparison of digital buzz against physical/digital retail footprint. Results are filtered by country, platform, and time window as specified.","failureModes":["Invalid or unsupported category slug returns an error — only pre-computed category root slugs are accepted, no wildcards","Requesting a time window not yet published (e.g. a future 90d window) returns an error","Limit outside 1–100 range is rejected","Unsupported country code (only 'us' and 'ca' are valid) returns validation error","Payment failure or insufficient USDC balance returns 402 response"],"whenToPreferThis":"Choose this endpoint when you need to cross-reference social media momentum (TikTok/Instagram) with actual retail shelf presence for brand ranking within a specific product category. It is uniquely suited for identifying brands whose social buzz is disproportionate to their market shelf share — a signal not available from pure social analytics or pure retail shelf tools. Prefer it over general social listening tools when you need the shelf-side join, and over share-of-shelf endpoints when social attention context is also needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:41.167Z","isFirstParty":false}