# Syntexa AgentShelf Brand Mention Brief

> Syntexa AgentShelf Brand Mention Brief is a paid API for AI agents from agentshelf.syntexa.ch, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-01).

Fetches structured brand/product mention briefs from public web sources, returning theme clusters, sentiment, and licensed samples.

## Facts

- Endpoint: POST https://agentshelf.syntexa.ch/v1/mentions?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/syntexa-agentshelf-brand-mention-brief-200ecac8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_dUzSIsRWkxzwix1J2pISs

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 syntexa-agentshelf-brand-mention-brief-200ecac8 -d '<json body>'
```

Example prompt: Pull together a brand mention brief for 'Morning Bloom Coffee' using Reddit and review sites over the last 30 days — English results only, up to 50 mentions, focused on the US — and give me the top theme clusters and overall sentiment.

## When to prefer this

Choose this endpoint when you need a ready-made, structured brand or product mention brief that aggregates theme clusters, sentiment, and licensed samples from multiple public sources in one call. Prefer the unpaid sandbox endpoint POST /v1/sandbox/mentions first for testing. This endpoint is ideal for market research, competitive intelligence, or reputation monitoring workflows where a pre-structured brief — not raw search results — is required. At $0.02 USDC per call it is cost-effective for per-query workflows; use it when you need multi-source aggregation across Reddit, web, reviews, and X with configurable geo, language, and time window filters.

## Known failure modes

- Query too short or too long (below 2 or above 80 characters) returns validation error
- Invalid source channel name returns schema validation error
- Lookback days exceeding 90 or limit outside 10-100 range returns parameter error
- Geo or lang string not recognized may return empty or degraded results
- Payment not confirmed on Base via x402 results in 402 Payment Required
- Rate limits or upstream source unavailability may cause partial results or timeout

## 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

A structured brand/product mention brief including theme clusters derived from aggregated public mentions, overall and per-source sentiment scores, and short licensed mention samples sourced from channels such as Reddit, web pages, and review sites.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "geo": {
   "type": "string",
   "maxLength": 32,
   "minLength": 2,
   "description": "Optional region filter, 2–32 characters. Omit it to search without a geo limit."
  },
  "lang": {
   "type": "string",
   "default": "en",
   "examples": [
    "en"
   ],
   "maxLength": 16,
   "minLength": 2,
   "description": "Language code such as en. Default en."
  },
  "limit": {
   "type": "integer",
   "default": 40,
   "maximum": 100,
   "minimum": 10,
   "examples": [
    40
   ],
   "description": "Maximum samples to return, from 10 to 100. Default 40."
  },
  "query": {
   "type": "string",
   "examples": [
    "acme widgets"
   ],
   "maxLength": 80,
   "minLength": 2,
   "description": "Brand or product name to search, 2–80 characters. Example: acme widgets."
  },
  "sources": {
   "type": "array",
   "items": {
    "enum": [
     "reddit",
     "web",
     "reviews",
     "x"
    ],
    "type": "string"
   },
   "default": [
    "web",
    "reviews"
   ],
   "examples": [
    [
     "web",
     "reviews"
    ]
   ],
   "minItems": 1,
   "description": "Sources to query. Any of reddit, web, reviews, x. Default web and reviews."
  },
  "lookback_days": {
   "type": "integer",
   "default": 30,
   "maximum": 90,
   "minimum": 1,
   "examples": [
    30
   ],
   "description": "How many days back to search, from 1 to 90. Default 30."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/syntexa-agentshelf-brand-mention-brief-200ecac8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentshelf.syntexa.ch](https://www.zero.xyz/host/agentshelf.syntexa.ch/llms.txt)