News Search

News Search

Requires API Key: Get one at https://api.search.brave.com

Plan: Included in the Search plan. See https://api-dashboard.search.brave.com/app/subscriptions/subscribe

Quick Start (cURL)

Basic Search

curl -s "https://api.search.brave.com/res/v1/news/search?q=space+exploration" \  -H "Accept: application/json" \  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}"

Recent News (Past 24 Hours)

curl -s "https://api.search.brave.com/res/v1/news/search" \  -H "Accept: application/json" \  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \  -G \  --data-urlencode "q=cybersecurity" \  --data-urlencode "country=US" \  --data-urlencode "freshness=pd" \  --data-urlencode "count=20"

Date Range Filter

curl -s "https://api.search.brave.com/res/v1/news/search" \  -H "Accept: application/json" \  -H "X-Subscription-Token: ${BRAVE_SEARCH_API_KEY}" \  -G \  --data-urlencode "q=climate summit" \  --data-urlencode "freshness=2026-01-01to2026-01-31"

Endpoint

GET https://api.search.brave.com/res/v1/news/searchPOST https://api.search.brave.com/res/v1/news/search

Authentication: X-Subscription-Token: <API_KEY> header

Note: Both GET and POST are supported. POST is useful for long queries or complex Goggles.

Parameters

Freshness Values

Response Format

{  "type": "news",  "query": {    "original": "space exploration"  },  "results": [    {      "type": "news_result",      "title": "New Developments in Space Exploration",      "url": "https://news.example.com/space-exploration",      "description": "Recent missions have advanced our understanding of...",      "age": "2 hours ago",      "page_age": "2026-01-15T14:30:00",      "page_fetched": "2026-01-15T15:00:00Z",      "meta_url": {        "scheme": "https",        "netloc": "news.example.com",        "hostname": "news.example.com",        "favicon": "https://imgs.search.brave.com/favicon/news.example.com",        "path": "/space-exploration"      },      "profile": {        "name": "Example Outlet",        "url": "https://news.example.com/space-exploration"      },      "thumbnail": {        "src": "https://imgs.search.brave.com/..."      }    }  ]}

Response Fields

Goggles (Custom Ranking) — Unique to Brave

Goggles let you re-rank news results — boost trusted outlets or suppress unwanted sources.

Hosted goggles must be on GitHub/GitLab, include ! name:, ! description:, ! author: headers, and be registered at https://search.brave.com/goggles/create. Inline rules need no registration.

Syntax: Rules start with $ + comma-separated options. Actions (pick one): discard, boost[=N], downrank[=N] — N is an integer 1–10. Site filter: site=DOMAIN. Example: $site=example.com,boost=3. Separate rules with \n (%0A).

Allow list: $discard\n$site=docs.python.org\n$site=developer.mozilla.org — Block list: $discard,site=pinterest.com\n$discard,site=quora.com

Resources: Discover · Syntax · Quickstart

Search Operators

Use search operators to refine results:

• site:local-paper.com - Limit to specific news site
• "exact phrase" - Match exact phrase
• -exclude - Exclude term

Set operators=false to disable operator parsing.

Use Cases

• Breaking news monitoring: Use freshness=pd for the most recent articles on a topic.
• Custom news feeds with Goggles: Boost trusted sources and discard other sources — unique to Brave.
• Historical news research: Use freshness=YYYY-MM-DDtoYYYY-MM-DD to find articles from specific time periods.
• Multilingual news: Combine country, search_lang, and ui_lang for cross-locale results.
• Data pipelines: Set include_fetch_metadata=true for fetched_content_timestamp on each result.

Notes

• SafeSearch: Defaults to strict
• Pagination: Use offset (0-9) with count
• Extra snippets: Up to 5 additional excerpts when extra_snippets=true