# News Brief — Topic News Clustering API

> News Brief — Topic News Clustering API is a paid API for AI agents from x402-micro-pay.com, paid per call via x402, $0.0101/call, status unknown (last checked 2026-11-20).

Fetches and clusters recent news headlines for a given topic from RSS feeds and GDELT, returning grouped story clusters with outlet metadata

## Facts

- Endpoint: POST https://x402-micro-pay.com/api/skills/news-brief?utm_source=zero.xyz
- Price: $0.0101/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-20
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/news-brief-topic-news-clustering-api-0a0b6ef9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VExh0xhh2ZE8QZX4cKtdZ

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 news-brief-topic-news-clustering-api-0a0b6ef9 -d '<json body>'
```

Example prompt: Give me a news brief on 'electric vehicles' covering the last 3 days, grouped into up to 10 story clusters.

## When to prefer this

Choose this endpoint when you need structured, clustered news coverage for a specific keyword or topic across multiple outlets, without setting up RSS parsing or news API credentials. Ideal for agents that need fresh news summaries on demand, especially in crypto, tech, or finance contexts. Prefer this over general web search when you want outlet-attributed, time-bounded, deduplicated headline clusters rather than raw search results.

## Known failure modes

- Topic too vague or short (minLength 2 enforced) — returns validation error
- No news found for topic in timespan — returns empty clusters array
- GDELT rate-limited — results fall back to RSS only, warning included in response
- Payment not sent — HTTP 402 returned with x402 payment requirements
- Request timeout if external feeds are slow — partial results may be returned
- max_clusters exceeds 20 — validation error returned

## How this service works

41 pay-per-call JSON APIs for AI agents. No account or API key: an unpaid POST returns HTTP 402, pay in USDC on Base with x402 v2, retry. Prices from $0.001 per call.

## Output

Returns a JSON object with clustered news stories for the requested topic. Each cluster contains a representative headline, list of outlet articles (URL, outlet name, publication time), and first/latest seen timestamps. Also includes a summary sentence, confidence score, total headline and cluster counts, data freshness timestamp, and warnings (e.g. if GDELT was unavailable). Sourced from publisher RSS feeds and optionally GDELT.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "topic": {
   "type": "string",
   "maxLength": 100,
   "minLength": 2
  },
  "timespan": {
   "enum": [
    "24h",
    "3d",
    "7d"
   ],
   "type": "string",
   "default": "24h"
  },
  "request_id": {
   "type": "string",
   "pattern": "^[A-Za-z0-9._:-]+$",
   "maxLength": 64,
   "minLength": 1,
   "description": "Optional idempotency key. Echoed back; a credit-pack redemption with the same request_id and body is charged once."
  },
  "max_clusters": {
   "type": "integer",
   "default": 10,
   "maximum": 20,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "data": {
   "terms": [
    "bitcoin"
   ],
   "topic": "bitcoin",
   "clusters": [
    {
     "latest": "2026-10-17T10:30:00Z",
     "outlets": [
      {
       "url": "https://www.wired.com/story/crypto-inheritance-how-to/",
       "via": "rss",
       "outlet": "Wired",
       "seen_at": "2026-10-17T10:30:00Z",
       "headline": "Don’t Let a Crypto Inheritance Get Stuck on the Blockchain"
      }
     ],
     "headline": "Don’t Let a Crypto Inheritance Get Stuck on the Blockchain",
     "first_seen": "2026-10-17T10:30:00Z",
     "outlet_count": 1
    },
    {
     "latest": "2026-10-17T06:39:48Z",
     "outlets": [
      {
       "url": "https://www.coindesk.com/tech/2026/10/17/wow-it-s-a-real-discovery-claude-cracks-a-25-year-nsa-number-mystery",
       "via": "rss",
       "outlet": "CoinDesk",
       "seen_at": "2026-10-17T06:39:48Z",
       "headline": "‘Wow, it’s a real discovery’: Claude cracks a 25-year NSA number mystery"
      }
     ],
     "headline": "‘Wow, it’s a real discovery’: Claude cracks a 25-year NSA number mystery",
     "first_seen": "2026-10-17T06:39:48Z",
     "outlet_count": 1
    }
   ],
   "searched": {
    "gdelt": false,
    "feeds_ok": 22,
    "feeds_total": 22
   },
   "timespan": "3d",
   "cluster_count": 2,
   "headline_count": 2
  },
  "next": [
   "url_to_markdown"
  ],
  "note": "Headlines and links only. No article text is republished.",
  "skill": "news_brief",
  "charged": true,
  "service": "news_brief",
  "sources": [
   {
    "url": "https://www.wired.com/feed/rss",
    "name": "Wired",
    "fetched_at": "2026-10-17T11:12:49Z"
   },
   {
    "url": "https://www.coindesk.com/arc/outboundfeeds/rss/",
    "name": "CoinDesk",
    "fetched_at": "2026-10-17T11:12:49Z"
   }
  ],
  "summary": "2 stories on 'bitcoin'; top: Don’t Let a Crypto Inheritance Get Stuck on the Blockchain",
  "version": "1.0.0",
  "warnings": [
   "headlines and links only; open the outlet URL for the article",
   "GDELT did not answer in time (it rate-limits shared IPs); results come from publisher RSS only"
  ],
  "confidence": 0.7,
  "data_as_of": "2026-10-17T11:12:49Z",
  "generated_at": "2026-10-17T11:12:56Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/news-brief-topic-news-clustering-api-0a0b6ef9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-micro-pay.com](https://www.zero.xyz/host/x402-micro-pay.com/llms.txt)
