# twitr.sh Radar – Trending Topics & Breaking Stories

> twitr.sh Radar – Trending Topics & Breaking Stories is a paid API for AI agents from twitr.sh, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Aggregates trending topics and breaking stories across categories like tech, science, politics, and entertainment from multiple public sources, with regional and time-window filters.

## Facts

- Endpoint: POST https://twitr.sh/api/tools/radar
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/twitr-sh-radar-trending-topics-breaking-stories-6130cab2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_k9LtofvJ5ChXHsPCOsjog

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 twitr-sh-radar-trending-topics-breaking-stories-6130cab2 -d '<json body>'
```

Example prompt: What's trending in tech and dev right now? Pull the top 10 stories from Hacker News over the last 24 hours.

## When to prefer this

Choose this endpoint when you need a fast, cheap, multi-source snapshot of what is trending right now across specific categories or regions. It is ideal for news briefings, trend monitoring, competitive intelligence, or feeding downstream summarization and analysis. Prefer it over full search endpoints when you want curated trend signals rather than keyword-specific results, and over social-media read endpoints when you need cross-platform aggregation in a single call.

## Known failure modes

- Invalid enum value for category or source returns a validation error
- No trending data available for the specified region or time window returns an empty result set
- Pagination cursor is expired or malformed, returning a cursor error
- Rate limit or payment failure results in a 402 or 429 response
- Extremely short hours window (e.g. hours=1) may return sparse results for niche categories

## How this service works

Trending topics and breaking stories across tech, dev, science, business, culture, politics, and entertainment — aggregated from multiple public sources with regional and time-window filters. Flat sub-cent price per call; the cheap first stop for what is happening right now.

## Output

Returns a list of trending topics or breaking stories matching the specified category, source, region, and time window, including story titles, source attribution, trend signals, and a pagination cursor for additional results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "after": {
   "type": "string",
   "description": "Pagination cursor."
  },
  "hours": {
   "type": "integer"
  },
  "limit": {
   "type": "integer"
  },
  "region": {
   "type": "string"
  },
  "source": {
   "enum": [
    "github",
    "google_trends",
    "hacker_news",
    "polymarket",
    "reddit",
    "trustmrr",
    "wikipedia"
   ],
   "type": "string",
   "description": "Trend source filter."
  },
  "category": {
   "enum": [
    "general",
    "tech",
    "dev",
    "science",
    "culture",
    "politics",
    "business",
    "entertainment"
   ],
   "type": "string",
   "description": "Topic category filter."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "url": "https://example.com/story",
    "score": 982,
    "title": "AI agents start paying for their own API calls",
    "category": "tech"
   }
  ],
  "runId": "tw_example",
  "payment": {
   "amount": "0.001000",
   "currency": "USD",
   "protocol": "x402"
  },
  "duration": 1
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/twitr-sh-radar-trending-topics-breaking-stories-6130cab2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from twitr.sh](https://www.zero.xyz/host/twitr.sh/llms.txt)