> ## Documentation Index
> Fetch the complete documentation index at: https://test-62a57ffd.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# News search

> Search from a dedicated index of news articles and outlets with advanced filtering and freshness options

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

<CardGroup cols={2}>
  <Card title="News-Specific Index" icon="newspaper">
    Search across a curated index of news articles from reputable news outlets
    worldwide
  </Card>

  <Card title="Freshness Filtering" icon="clock">
    Filter results by discovery date - from last 24 hours to custom date ranges
  </Card>

  <Card title="Country & Language Options" icon="language">
    Target news from specific countries and in preferred languages
  </Card>

  <Card title="Extra Snippets" icon="quote-left">
    Get up to 5 additional alternative excerpts per result **(AI/Data Plans)**
  </Card>
</CardGroup>

<Note>
  Extra snippets feature is available on **Free AI**, **Base AI**, **Pro AI**,
  **Base Data**, **Pro Data** and **Custom plans**. [View pricing](/pricing) for
  more details.
</Note>

## API Reference

<Card title="News Search API Documentation" icon="code" href="/api-reference/news/search">
  View the complete API reference, including endpoints, parameters, and example
  requests
</Card>

## 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 theme={null}
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:

```bash theme={null}
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:

```bash theme={null}
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](https://github.com/brave/goggles-quickstart), 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](https://search.brave.com/help/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 theme={null}
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>"
```

## Safe Search

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.