{"uid":"cap_qUbaI6-9PO3vXQnOx4HqX","slug":"brave-search-news-00441f41","name":"Brave Search News","description":"News search over Brave's independent index. Returns recent articles with title, URL, source, and age. Use it for current events, where web search can surface older pages. Pass q, and optionally count, country, and freshness.","url":"https://search.agent.s.brave.app/res/v1/news/search?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","maxLength":400,"description":"Search query"},"count":{"type":"integer","default":20,"maximum":50,"minimum":1},"offset":{"type":"integer","maximum":9,"minimum":0,"description":"Pages of count results to skip"},"country":{"type":"string","description":"Country code such as US, or ALL"},"freshness":{"type":"string","description":"pd, pw, pm, py, or a range like 2026-01-01to2026-06-30"},"safesearch":{"enum":["off","moderate","strict"],"type":"string","default":"strict"},"search_lang":{"type":"string","description":"Language code such as en"}}}}},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"type":{"type":"string"},"query":{"type":"object","properties":{"original":{"type":"string"}}},"results":{"type":"array","items":{"type":"object","properties":{"age":{"type":"string"},"url":{"type":"string"},"type":{"type":"string"},"title":{"type":"string"},"page_age":{"type":"string"}}}}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_iO5RUtKE2Nc2MgNmJeqg1","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Searches Brave's independent news index and returns recent articles with title, URL, source, and age for current events coverage.","exampleAgentPrompt":"Search Brave News for the latest articles about the Federal Reserve interest rate decision from the past week — give me up to 10 results from US sources.","exampleUseCases":[{"title":"Breaking news on a corporate event","prompt":"Search Brave News for the latest articles about Apple's earnings report from the past week — I want up to 15 results in English from US sources."},{"title":"Monitoring a geopolitical situation","prompt":"Find me recent news from the past month about the conflict in Ukraine using Brave's news search — get 20 results and focus on English-language coverage."},{"title":"Tracking a product launch","prompt":"Pull the latest Brave News articles about the new GPT model release from the past day — give me 10 results so I can see how media is covering it."}],"resultDescription":"An array of news article objects, each containing the article title, URL, source name, article age (human-readable), and page age (ISO-formatted date). The response also echoes back the original query.","failureModes":["Missing required 'q' parameter returns a 400 error","Invalid freshness format (e.g. wrong date range syntax) may return no results or an error","Country code not recognized may fall back to global results","Offset beyond maximum of 9 returns an error","Count exceeding 50 is rejected","Query returning no matching news yields an empty results array","Payment not included or insufficient USDC triggers a 402 response"],"whenToPreferThis":"Choose this endpoint over web search when you need recent or breaking news specifically — it targets a news-optimized index so results are more timely than general web pages. Use the freshness parameter to narrow to the past day, week, or month. Prefer this over social media APIs when you need structured article metadata (title, URL, source, age) rather than social posts. Use the country filter when regional news coverage matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T19:29:16.472Z","isFirstParty":false,"canonicalSlug":"brave-search-news-00441f41"}