Overview

News Search lets you send queries and receive relevant news from a specialized index of articles sourced from trusted outlets worldwide. With continuous crawling and indexing, you get access to breaking news, historical articles, and comprehensive coverage for your applications.

Key Features

API Reference

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 "https://api.search.brave.com/res/v1/news/search?q=climate+summit&freshness=pw" \
  -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 "https://api.search.brave.com/res/v1/news/search?q=élections&country=FR&search_lang=fr" \
  -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 "https://api.search.brave.com/res/v1/news/search?q=artificial+intelligence&extra_snippets=true" \
  -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 "https://api.search.brave.com/res/v1/news/search?q=sports&count=20&offset=1" \
  -H "X-Subscription-Token: <YOUR_API_KEY>"

Safe Search

Control adult content filtering with the safesearch parameter:

• off: No filtering
• moderate: Filter explicit content
• strict: Filter explicit and suggestive content (default)

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.