Skip to main content

​
Overview

News Search provides access to a specialized index of news articles from trusted news outlets worldwide. Our service continuously crawls and indexes news content, enabling you to retrieve the latest breaking news, historical articles, and comprehensive news coverage for your applications.

​
Key Features

News-Specific Index

Search across a curated index of news articles from reputable news outlets worldwide

Freshness Filtering

Filter results by discovery date - from last 24 hours to custom date ranges

Country & Language Options

Target news from specific countries and in preferred languages

Extra Snippets

Get up to 5 additional alternative excerpts per result (AI/Data Plans)
Extra snippets feature is available on Free AI, Base AI, Pro AI, Base Data, Pro Data and Custom plans. View pricing for more details.

​
API Reference

News Search API Documentation

View the complete API reference, including endpoints, parameters, and example requests

​
Use Cases

News Search is perfect for:
  • News Aggregation: Build news applications and aggregators with real-time content
  • Media Monitoring: Track news mentions, brand coverage, and industry trends
  • Current Events Analysis: Monitor breaking news and emerging stories
  • Content Discovery: Find news articles for research and content curation
  • Historical News Research: Access archived news articles with date filtering

​
Freshness Filtering

News Search offers powerful date-based filtering to help you find the most relevant content:
  • Last 24 Hours (pd): Get breaking news and latest updates
  • Last 7 Days (pw): Track weekly news trends
  • Last 31 Days (pm): Monitor monthly developments
  • Last Year (py): Search annual news coverage
  • Custom Date Range: Specify exact timeframes (e.g., 2022-04-01to2022-07-30)
Example request filtering for news from the past week: 
curl -s --compressed "https://api.search.brave.com/res/v1/news/search?q=climate+summit&freshness=pw" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

​
Country and Language Targeting

Customize your news search results by specifying:
  • Country: Target news from specific countries using 2-character country codes
  • Search Language: Filter results by content language
  • UI Language: Set the preferred language for response metadata
Example request for French news from France: 
curl -s --compressed "https://api.search.brave.com/res/v1/news/search?q=élections&country=FR&search_lang=fr" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

​
Extra Snippets

The extra snippets feature provides up to 5 additional excerpts per search result, giving you more context and alternative perspectives from each article. This is particularly useful for:
  • Comprehensive content preview
  • Better relevance assessment
  • Enhanced user experience in news applications
To enable extra snippets: 
curl -s --compressed "https://api.search.brave.com/res/v1/news/search?q=artificial+intelligence&extra_snippets=true" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

​
Goggles Support

News Search supports Goggles, which allow you to apply custom re-ranking on top of search results. You can:
  • Boost or demote specific news sources
  • Filter by custom criteria
  • Create personalized news ranking algorithms
Goggles can be provided as a URL or inline definition, and multiple goggles can be combined.

​
Search Operators

News Search supports search operators to refine your queries:
  • Use quotes for exact phrase matching: "climate change"
  • Exclude terms with minus: technology -cryptocurrency
  • Site-specific searches: site:reuters.com elections

​
Pagination

Efficiently paginate through news results:
  • count: Number of results per page (max 50, default 20)
  • offset: Page number to retrieve (0-based, max 9)
Example request for page 2 with 20 results per page: 
curl -s --compressed "https://api.search.brave.com/res/v1/news/search?q=sports&count=20&offset=1" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"
Control adult content filtering with the safesearch parameter:
  • off: No filtering
  • moderate: Filter explicit content (default)
  • strict: Filter explicit and suggestive content

​
Changelog

This changelog outlines all significant changes to the Brave News Search API in chronological order.
  • 2023-08-15 Add Brave News Search API resource.
  • 2024-03-20 Add freshness filtering with custom date ranges.
  • 2024-09-10 Add extra snippets feature for AI and Data plans.
  • 2025-01-15 Add Goggles support for custom re-ranking.
⌘I