# Briefing Service – Hourly Ranked News Briefing (JSON)

> Briefing Service – Hourly Ranked News Briefing (JSON) is a paid API for AI agents from briefing-service.wholemind.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-17).

Fetches a single hourly ranked news briefing as structured JSON, including a lead story, ranked items, and research links for a given topic key.

## Facts

- Endpoint: GET https://briefing-service.wholemind.workers.dev/v1/briefings/%7Bkey%7D
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/briefing-service-hourly-ranked-news-briefing-json-c38632b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_l1sZji8mG2U6x_NMa4W0t

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 briefing-service-hourly-ranked-news-briefing-json-c38632b2
```

Example prompt: Pull me the latest hourly ranked news briefing for the 'ai' topic key and show me the lead story, the top ranked items, and any research links.

## When to prefer this

Use this endpoint when you need a structured, ranked, and editorially curated news briefing for a specific topic (e.g. ai, finance, sports, soccer, us, world) delivered as machine-readable JSON with full story detail, source attribution, and ranking rationale. Prefer this over generic news APIs when you need pre-ranked, topic-scoped briefings with bullet-point breakdowns and research links rather than raw article feeds.

## Known failure modes

- Invalid or unrecognized topic key returns an error or empty result
- Briefing not yet generated for the current hour may return stale or missing data
- Payment not processed (x402) results in 402 Payment Required before content is served
- Network timeout from Cloudflare Worker under high load

## How this service works

Every hour an LLM editor re-picks ~100 feeds per topic. JSON and MCP for agents, 1-bit pages for e-ink, a morning paper for reMarkable, Kindle or your inbox. Free tier, no key.

## Output

A JSON object containing a 'ranking' field with: a 'lead' story object (headline, summary, detail, bullet points, source, link, published timestamp, and a 'why' explanation), an 'items' array of similarly structured ranked stories, a 'kicker' string, and a 'research' array of additional sourced stories. Also includes a top-level 'ranked_at' ISO timestamp indicating when the briefing was generated.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ranking": {
   "lead": {
    "why": "…",
    "link": "https://…",
    "detail": "…",
    "points": [
     "…"
    ],
    "source": "The Verge",
    "summary": "…",
    "headline": "…",
    "published": "2026-09-07T20:00:00Z"
   },
   "items": [
    {
     "why": "…",
     "link": "https://…",
     "detail": "…",
     "points": [
      "…"
     ],
     "source": "The Verge",
     "summary": "…",
     "headline": "…",
     "published": "2026-09-07T20:00:00Z"
    }
   ],
   "kicker": "…",
   "research": [
    {
     "why": "…",
     "link": "https://…",
     "detail": "…",
     "points": [
      "…"
     ],
     "source": "The Verge",
     "summary": "…",
     "headline": "…",
     "published": "2026-09-07T20:00:00Z"
    }
   ]
  },
  "ranked_at": "2026-09-07T23:53:54Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/briefing-service-hourly-ranked-news-briefing-json-c38632b2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from briefing-service.wholemind.workers.dev](https://www.zero.xyz/host/briefing-service.wholemind.workers.dev/llms.txt)