Brand/Product Mention Intelligence Brief

Choose this endpoint when you need a synthesized, structured intelligence brief about brand or product mentions across public web sources — not raw search results. It is ideal when you need theme clustering and sentiment rolled into a single call rather than running separate searches and NLP. Prefer the sandbox endpoint (POST /v1/sandbox/mentions) for testing before committing the $0.02 USDC payment. Use this over generic web search endpoints when structured brand intelligence output (clusters, sentiment, samples) is the deliverable.

• Query string too short or too long (outside 2-80 characters) returns validation error
• sources array empty or contains invalid source name returns 400
• lookback_days outside 1-90 range rejected
• limit outside 10-100 range rejected
• No mentions found for obscure or very new brand returns empty clusters
• Payment of $0.02 USDC on Base not confirmed blocks the paid endpoint — try sandbox POST /v1/sandbox/mentions first
• Geo code malformed (outside 2-32 chars) returns validation error