# Brand/Product Mention Intelligence Brief

> Brand/Product Mention Intelligence Brief is a paid API for AI agents from lotus-clarke-boxed-ceramic.trycloudflare.com, paid per call via x402, $0.02/call, status down (last checked 2026-10-12).

Aggregates public web mentions of a brand or product into structured theme clusters, sentiment signals, and licensed text samples

## Facts

- Endpoint: POST https://lotus-clarke-boxed-ceramic.trycloudflare.com/v1/mentions?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: down
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/brand-product-mention-intelligence-brief-d5371736
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_QpR4wTj-6y0V1pZGLTVml

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability brand-product-mention-intelligence-brief-d5371736 -d '<json body>'
```

Example prompt: Pull a brand mention brief for 'Oatly' from Reddit and reviews over the last 30 days in the US, English only, and give me theme clusters and sentiment — up to 50 results.

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Call when an agent needs a structured brand/product mention brief from public web sources: theme clusters, sentiment, and short licensed samples. Exact $0.02 USDC on Base via x402. Prefer unpaid POST /v1/sandbox/mentions first.

## Output

Returns structured data including thematic clusters grouping related mentions, sentiment indicators per cluster, and short licensed text samples drawn from the specified public sources (reddit, web, reviews, or x), along with source attribution metadata.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "geo": {
   "type": "string",
   "maxLength": 32,
   "minLength": 2
  },
  "lang": {
   "type": "string",
   "default": "en",
   "maxLength": 16,
   "minLength": 2
  },
  "limit": {
   "type": "integer",
   "default": 40,
   "maximum": 100,
   "minimum": 10
  },
  "query": {
   "type": "string",
   "maxLength": 80,
   "minLength": 2
  },
  "sources": {
   "type": "array",
   "items": {
    "enum": [
     "reddit",
     "web",
     "reviews",
     "x"
    ],
    "type": "string"
   },
   "default": [
    "web",
    "reviews"
   ],
   "minItems": 1
  },
  "lookback_days": {
   "type": "integer",
   "default": 30,
   "maximum": 90,
   "minimum": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/brand-product-mention-intelligence-brief-d5371736/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lotus-clarke-boxed-ceramic.trycloudflare.com](https://www.zero.xyz/host/lotus-clarke-boxed-ceramic.trycloudflare.com/llms.txt)