{"uid":"cap_ukeRoPqULwPrtSH3SSYyr","slug":"grokzilla-news-brief-topic-to-story-clusters-59579358","name":"Grokzilla News Brief – Topic-to-Story Clusters","description":"Topic in, deduplicated story clusters out: headline, every outlet URL and first-seen time, from GDELT and publisher RSS. Headlines and links only, no article text. Not charged when nothing matches or sources fail.","url":"https://grokzilla.shop/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_eG0J4td3YbKBQFjJTq-IE","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":"Takes a topic string and returns deduplicated news story clusters with headlines and outlet URLs, sourced from GDELT and publisher RSS feeds, over a configurable time window.","exampleAgentPrompt":"Can you pull the top 10 news story clusters about 'electric vehicle recalls' from the past 3 days — I want the headlines and all outlet URLs grouped by story?","exampleUseCases":[{"title":"Breaking story coverage tracker","prompt":"Get me up to 15 clustered news stories about 'OpenAI' from the last 24 hours, with every outlet URL and when each story was first seen."},{"title":"Weekly topic briefing for newsletter","prompt":"Pull the top 20 story clusters covering 'climate policy' over the past 7 days — just headlines and links, grouped by story, so I can put together a weekly digest."},{"title":"Competitive monitoring for PR team","prompt":"What are the news story clusters mentioning 'Rivian' from the past 3 days? Give me up to 10 clusters with all outlet URLs."}],"resultDescription":"A list of deduplicated story clusters, each containing a headline, all outlet URLs that covered the story, and the first-seen timestamp for each outlet. Returns up to max_clusters results (default 10, max 20). No article body text is included. No charge is applied if no stories match or if sources are unavailable.","failureModes":["No matching stories found for topic — returns empty result set, no charge applied","Source failure (GDELT or RSS unavailable) — returns empty or partial result, no charge applied","Topic string too short (<2 chars) or too long (>100 chars) — validation error","Invalid timespan value — must be one of 24h, 3d, 7d","max_clusters out of range (must be 1–20) — validation error","Duplicate request_id with same body — idempotently returns prior result without additional charge"],"whenToPreferThis":"Use this endpoint when you need fast, deduplicated multi-source news clustering for a specific topic with minimal cost per call. Prefer it over full-text article APIs when headlines and outlet links are sufficient. It excels at media monitoring, newsletter curation, and event coverage aggregation. The GDELT + RSS sourcing gives broad coverage across publishers. The per-call pricing and free-on-no-match policy make it safe for speculative topic queries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:49:34.700Z","isFirstParty":false,"canonicalSlug":"grokzilla-news-brief-topic-to-story-clusters-59579358"}