{"uid":"cap_ZwX1HwCtyX-qBul8Ddk36","slug":"news-situation-brief-rag-synthesized-summary-a4dc299d","name":"News Situation Brief (RAG-Synthesized Summary)","description":"Situation brief on a topic (RAG over fresh news): searches recent news, reads the top articles and synthesizes a short cited summary of what is currently happening plus key points. Cites only the retrieved articles (anti-hallucination).","url":"https://api.agentstools.dev/news/brief","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["topic"],"properties":{"query":{"type":"string","description":"Alias for topic (either is accepted)"},"topic":{"type":"string","description":"The topic to brief on"},"region":{"type":"string","description":"Locale like 'us-en', 'uk-en' (default us-en)"},"timelimit":{"enum":["d","w","m","y"],"type":"string","description":"Freshness filter (default w = past week)"},"max_sources":{"type":"integer","maximum":10,"minimum":1,"description":"How many articles to read (default 5)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_SAX0X1tRst580DoB0yTeP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches recent news, reads top articles, and synthesizes a short cited situation brief on any topic using retrieval-augmented generation.","exampleAgentPrompt":"Give me a situation brief on the US-China trade war — search the past week of news, read up to 5 articles, and give me a cited summary of what's happening right now.","exampleUseCases":null,"resultDescription":"A short cited summary of the current situation on the given topic, including key points and references to the specific news articles that were retrieved and read. Only retrieved articles are cited, preventing hallucination.","failureModes":["No recent articles found for obscure or very niche topics","Timelimit too narrow (e.g. 'd') with low-news topics returns sparse results","Invalid region/locale string may fall back to default us-en or error","max_sources out of bounds (must be 1–10) returns validation error","Payment failure (402) if USDC balance insufficient for $0.04 per call","Network timeout if upstream news engines are slow to respond"],"whenToPreferThis":"Choose this endpoint when you need a synthesized, cited narrative summary of current events on a topic — not just raw headlines. It is better than a raw news search when you want anti-hallucination guarantees (citations only from retrieved articles), a digestible briefing rather than a list of links, and a synthesis of multiple sources into key points. Prefer the sibling keyword search endpoint if you only need headline lists or raw article metadata.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:59:58.469Z","isFirstParty":false}