{"uid":"cap_l1sZji8mG2U6x_NMa4W0t","slug":"briefing-service-hourly-ranked-news-briefing-json-c38632b2","name":"Briefing Service – Hourly Ranked News Briefing (JSON)","description":"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.","url":"https://briefing-service.wholemind.workers.dev/v1/briefings/%7Bkey%7D","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"properties":{"type":"string"}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GDICzQRgToc2iHZjhVUHG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a single hourly ranked news briefing as structured JSON, including a lead story, ranked items, and research links for a given topic key.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Morning AI news digest","prompt":"Give me the current ranked news briefing for the 'ai' key — I want to see the lead story, all the ranked items, and why each one matters."},{"title":"Finance news summary for trading desk","prompt":"Fetch the latest hourly briefing for the 'finance' topic and show me the headlines, summaries, and sources for the lead and all ranked items."},{"title":"Soccer match news roundup","prompt":"Get me the most recent ranked news briefing for 'soccer' — what's the lead story this hour and what are the top stories with links?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T18:48:23.424Z","isFirstParty":false}