{"uid":"cap_VExh0xhh2ZE8QZX4cKtdZ","slug":"news-brief-topic-news-clustering-api-0a0b6ef9","name":"News Brief — Topic News Clustering API","description":"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.","url":"https://x402-micro-pay.com/api/skills/news-brief?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0101","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.0101/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0101","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0101","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dJ87AYUuX9LvtGbk3IyST","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0101","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches and clusters recent news headlines for a given topic from RSS feeds and GDELT, returning grouped story clusters with outlet metadata","exampleAgentPrompt":"Give me a news brief on 'electric vehicles' covering the last 3 days, grouped into up to 10 story clusters.","exampleUseCases":[{"title":"Morning crypto news digest","prompt":"Pull me a news brief on 'ethereum' from the last 24 hours, up to 10 clusters — I want to see the top headlines and which outlets covered them."},{"title":"Weekly AI research coverage","prompt":"What have major outlets published about 'artificial intelligence' in the past 7 days? Give me up to 15 story clusters so I can see how coverage is grouped."},{"title":"Breaking news check on a company","prompt":"Get me the latest news brief on 'Tesla' from the last 24 hours, grouped into up to 5 clusters, so I can see if anything significant broke today."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-20T06:51:51.540Z","isFirstParty":false,"canonicalSlug":"news-brief-topic-news-clustering-api-0a0b6ef9"}