Syntalic Attention vs Shelf

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.

• 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