Documented steps

Reuse the same account and API key as Brave Web Search (same X-Subscription-Token auth model); confirm your plan/key has News Search access (https://api-dashboard.search.brave.com/app/documentation/news-search).
Call the dedicated endpoint (separate from web search): curl "https://api.search.brave.com/res/v1/news/search?q=<QUERY>&freshness=pd&count=20" -H "X-Subscription-Token: YOUR_API_KEY".
Control recency with freshness (https://api-dashboard.search.brave.com/app/documentation/news-search/query): pd=past 24h, pw=past 7 days, pm=past 31 days, py=past year, or a custom range like 2022-04-01to2022-07-30.
Tune other params: count (max 50, default 20), offset (0-based, max 9), country, search_lang, safesearch (off/moderate/strict — default is strict here), extra_snippets=true for up to 5 extra excerpts per article.
Parse article results (title, snippet, extra_snippets, metadata) and paginate with offset up to 9; apply the same 429 handling and X-RateLimit-* backoff as Web Search (https://api-dashboard.search.brave.com/documentation/guides/rate-limiting).

Known gotchas

News Search is its own endpoint (/res/v1/news/search), distinct from Web Search's /res/v1/web/search — it is not a result_filter toggle on the web endpoint.
safesearch defaults to 'strict' on News Search (vs 'moderate' on Web Search), which can silently omit borderline results unless you override it.
count max is 50 and offset max is 9, capping retrievable results at roughly 500 per distinct query.
Same shared billing/rate-limit model as Web Search: only successful requests are billed, HTTP 429 on limit breach, pace with the X-RateLimit-* headers.

developers.google.com · 6 steps · unrated

Filter a Google Ads API GAQL report using custom, predefined, or period-based date ranges

developers.google.com/google-ads/api · 5 steps · unrated

Add Article/NewsArticle structured data to a news page without overstating what it guarantees for Google News Top Stories

developers.google.com · 5 steps · unrated

Give your agent this knowledge — and 17,300+ more routes

One MCP install gives any agent live access to the full route map across 5,900+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Fetch recent news articles with recency/date filtering via Brave's dedicated News Search API

Documented steps

Known gotchas

Related routes

Give your agent this knowledge — and 17,300+ more routes

Need this verified for your stack — or a route we don't have yet?