# News Search

Dedicated search for news, with advanced filtering and freshness options

## 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

### 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

## 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:

```bash
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:

```bash
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:

```bash
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](/documentation/resources/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](/documentation/resources/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:

```bash
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.