Our Brave News API allows you to scrape results from the Brave News search page.


The API endpoint is https://serpapi.com/search?engine=brave_news

Head to the playground for a live and interactive demo.

API parameters

Search query

q

Required

Parameter defines the query you want to search. You can use anything that you would use in a regular Brave News search (e.g., bitcoin, or site: and other search operators).

Unsupported search operators:
intitle:, allintitle:
intext:, allintext:
inurl:, allinurl:
inanchor:, allinanchor:

Use inpage: to search in the titles and the bodies of pages, or inbody: to search in their bodies.

Localization

country

Optional

Parameter defines the country to use for the Brave News search. It's a two-letter country code (e.g., us (default) for the United States, gb for the United Kingdom, or fr for France), or all for all regions. Head to the Brave countries page for a full list of supported countries.

language

Optional

Parameter defines the language to use for the Brave News search: the language of the dates (e.g., 1 day ago). It doesn't change the language of the news. It's a two-letter language code (e.g., en (default) for English, es for Spanish, or fr for French). Head to the Brave languages page for a full list of supported languages.

Advanced filters

tf

Optional

Parameter defines the time period of the news, like Brave's time filter. It can be one of the options below, or a date range in the format of YYYY-MM-DDtoYYYY-MM-DD (e.g., 2026-01-01to2026-01-31).

Available options:
pd - Past day
pw - Past week
pm - Past month
py - Past year

spellcheck

Optional

Parameter defines whether Brave corrects the spelling of the query. It defaults to 1, like on Brave. The spelling fix is in search_information.spelling_fix.

Available options:
0 - Autocorrection off
1 - Autocorrection on

Pagination

offset

Optional

Parameter defines the page of results to return. (e.g., 0 (default) is the first page of results, and 1 is the 2nd page of results). It can be up to 1, the last page Brave News offers. Brave News returns up to 50 results per page, and serpapi_pagination.next is only present when there's a next page.

SerpApi parameters

engine

Required

Set parameter to brave_news to use the Brave News API engine.

no_cache

Optional

Parameter will force SerpApi to fetch the Brave News results even if a cached version is already present. A cache is served only if the query and all parameters are exactly the same. Cache expires after 1h. Cached searches are free, and are not counted towards your searches per month. It can be set to false (default) to allow results from the cache, or true to disallow results from the cache. no_cache and async parameters should not be used together.

async

Optional

Parameter defines the way you want to submit your search to SerpApi. It can be set to false (default) to open an HTTP connection and keep it open until you got your search results, or true to just submit your search to SerpApi and retrieve them later. In this case, you'll need to use our Searches Archive API to retrieve your results. async and no_cache parameters should not be used together. async should not be used on accounts with Ludicrous Speed enabled.

zero_trace

Optional

Enterprise only. Parameter enables ZeroTrace mode. It can be set to false (default) or true. Enable this mode to skip storing search parameters, search files, and search metadata on our servers. This may make debugging more difficult.

api_key

Required

Parameter defines the SerpApi private key to use.

output

Optional

Parameter defines the format of the result. It can be set to json (default) to get a structured JSON of the results, html to get the raw HTML retrieved, or md to get a Markdown-formatted version optimized for LLMs and AI agents.

json_restrictor

Optional

Parameter defines the fields you want to include in the output, reducing payload size for faster response. See the JSON Restrictor documentation for more details.

API results

JSON results

JSON output includes structured data for news results.

A search status is accessible through search_metadata.status. It flows this way: Processing -> Success || Error. If a search has failed, error will contain an error message. search_metadata.id is the search ID inside SerpApi.

HTML results

This API does not have a full HTML response, only text. search_metadata.prettify_html_file contains a link to the prettified version of the result. It is displayed in the playground.

Markdown results

Markdown output is optimized for LLMs and AI agents. It provides a curated view of the JSON results in a token-efficient format using tables, markdown links, and YAML frontmatter.

To access, use the output=md parameter, the /search.md endpoint, or request header Accept: text/markdown.

API examples

Example with q: Coffee

Example with q: Coffee

JSON Example

{
  ...
  "news_results": [
    {
      "title": "Regular coffee drinking linked to changes in gut motility and microbiome | Euronews",
      "link": "https://euronews.com/2026/11/14/regular-coffee-drinking-linked-to-changes-in-gut-motility-and-microbiome",
      "snippet": "The research team used a small electronic capsule that participants swallowed to monitor changes as it passed through the digestive system.",
      "source": "euronews",
      "date": "3 days ago",
      "thumbnail": "https://imgs.search.brave.com/_9KMpXVXfR9iIze2ClbScKUKpUCH8xuBtwRpzf1dOXQ/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9pbWFn/ZXMuZXVyb25ld3Mu/Y29tL2FydGljbGVz/L3N0b3JpZXMvMDkv/OTgvODcvNTQvMTIw/MHg2NzVfY21zdjJf/Y2U2NDAxZTEtMzJj/Mi01ZGQ3LWIyZmQt/YTVhMjY2NmUzZGJl/LTk5ODg3NTQuanBn",
      "favicon": "https://imgs.search.brave.com/YHwdxHTQIujkueliB2VIksurpENPxI4z7AV-WIQlvZ8/rs:fit:32:32:1:0/g:ce/aHR0cDovL2Zhdmlj/b25zLnNlYXJjaC5i/cmF2ZS5jb20vaWNv/bnMvMzZkZWEyNzQ1/YjhiMWNmODcyMmRi/MDUwMzM1M2FlZTBk/ODUzNzVkMDc2MWY4/MDEyOWM2YzM4YWQ4/ODVkMzEzMi9ldXJv/bmV3cy5jb20v"
    },
    {
      "title": "Black Rifle Coffee closing at least 12 company-owned locations",
      "link": "https://www.audacy.com/krld/news/local/black-rifle-coffee-closing-at-least-12-company-owned-locations",
      "snippet": "If you get your coffee at Black Rifle Coffee, you could soon see some locations disappear.",
      "source": "Audacy",
      "date": "7 hours ago",
      "thumbnail": "https://imgs.search.brave.com/QlpUNIspmbh4RSneEoE_r93ATD4HIAEfqc_eCEpZQl4/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly93d3cu/YXVkYWN5LmNvbS9t/ZWRpYS1saWJyYXJ5/L2NvZmZlZS5qcGc_/aWQ9NjQ3NzUyMDMm/d2lkdGg9MTIwMCZo/ZWlnaHQ9NjAwJmNv/b3JkaW5hdGVzPTAl/MkMxNjYlMkMwJTJD/MTY3",
      "favicon": "https://imgs.search.brave.com/t9Zq4eK5BLVVNBQWpg84JsCN3B-H_TtuI1I6qXuMiIU/rs:fit:32:32:1:0/g:ce/aHR0cDovL2Zhdmlj/b25zLnNlYXJjaC5i/cmF2ZS5jb20vaWNv/bnMvMDY1YWMxMjMy/ZjlkNmNmMWE0ZWZj/ZmM3M2NjYTUzMGEx/MjY0M2NmMzA3YWQx/YWQ4OGExMzFlOGQ4/ZjljZDI1Ny93d3cu/YXVkYWN5LmNvbS8"
    },
    ...
  ],
  ...
}

Example with country: fr

Brave News ranks the news for the country of the search. When country isn't set, the search is from the United States (us), so the results don't depend on where the request comes from. Use all for news from all regions.

Example with country: fr

JSON Example

{
  ...
  "search_parameters": {
    "engine": "brave_news",
    "q": "rugby",
    "country": "fr",
    "language": "en"
  },
  "news_results": [
    {
      "title": "Rugby / Régionale 3 : La Brède et Aillas s’imposent en patrons, Cadillac signe une belle perf",
      "link": "https://www.sudouest.fr/sport/rugby/rugby-regionale-3/football-regionale-3-la-brede-et-aillas-s-imposent-en-patrons-cadillac-signe-une-belle-perf-31550931.php",
      "snippet": "La Brède (Régionale 3) et Aillas (Promotion Régionale 3) continuent de gagner et restent leaders de leurs poules respectives. En déplacement, l’Union Rugby Gascon a pris le bonus défensif, et Cadillac a ramené une belle victoire, ce week-end des 14 et 15 novembre",
      "source": "SudOuest.fr",
      "date": "3 hours ago",
      "thumbnail": "https://imgs.search.brave.com/Uul8xexs_WZOBLb5SAg4e_KPKZxZEq7x7GPQjfDi54U/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9tZWRp/YS5zdWRvdWVzdC5m/ci8zMTU1MDkzMS8x/MjAweC0xL3Nwb3J0/c3N1ZC1naXJvbmRl/LWVkYWQzNTNhMjA2/YTRiMDZiOWE5YTQ2/NWRiZjFiNDlkLTE2/MDQwNi1waDAuanBn",
      "favicon": "https://imgs.search.brave.com/ddvLVjWPxxRjbMjKVfA2fvjg6qzcBxTsiSrqleLSOOU/rs:fit:32:32:1:0/g:ce/aHR0cDovL2Zhdmlj/b25zLnNlYXJjaC5i/cmF2ZS5jb20vaWNv/bnMvNWFhYzY0Nzhk/ZmY4ZmNkODg0NDM2/MTc0OTUxMzM2Yzkw/OGRjZjNhNmU1MGRj/M2NmMmVmZjliMjBm/YjgwZmQwZS93d3cu/c3Vkb3Vlc3QuZnIv"
    },
    ...
  ],
  ...
}

Example with tf: pw

With tf, the API only returns news from the past day, week, month, or year, or from a date range like 2026-11-01to2026-11-10. Like Brave News, the time filter opens the filters of the page.

Example with tf: pw

JSON Example

{
  ...
  "search_parameters": {
    "engine": "brave_news",
    "q": "nasa",
    "country": "us",
    "language": "en",
    "tf": "pw"
  },
  "news_results": [
    {
      "title": "What are sprites? NASA wants photos of these rare flashes",
      "link": "https://weather.com/2026/11/15/science/weather-explainers/what-are-sprites-red-flashes-above-storms",
      "snippet": "Sprites are brief red flashes of light high above thunderstorms. Learn what they are and how your photos can help NASA's Spritacular project study them.",
      "source": "The Weather Channel",
      "date": "1 day ago",
      "thumbnail": "https://imgs.search.brave.com/6OACkUApVzb3lrbNKrNTEVpvnh0ikmgxGA_hzEs10QU/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9zLnct/eC5jby93eG5leHQv/aW1nL3RoYW5hc2lz/X3BhcGF0aGFuYXNp/b3VfLV90bGVfMDVf/LV90aGFuYXNpc19w/YXBhdGhhbmFzaW91/XzB3LWZiZDkxOS53/ZWJw",
      "favicon": "https://imgs.search.brave.com/OdtvQPcQyqoC26yfAt79pHA0oO7vRAaIx1JQqy0Up3k/rs:fit:32:32:1:0/g:ce/aHR0cDovL2Zhdmlj/b25zLnNlYXJjaC5i/cmF2ZS5jb20vaWNv/bnMvZWIyNjhkZjI0/YmNiYmY2MTM1MDk4/OWJhNTliODY0ZGFj/OThhMjhiYzMyN2Mz/ZjJiODgxN2EwNDUw/NzY3YjBjOS93ZWF0/aGVyLmNvbS8"
    },
    ...
  ],
  ...
}

Example with a misspelled query: nvidea

Like Brave News, the API searches for the spelling fix of a misspelled query, which is in search_information.spelling_fix.

Example with a misspelled query: nvidea

JSON Example

{
  ...
  "search_information": {
    "spelling_fix": "nvidia",
    "news_results_state": "Showing results for fixed spelling"
  },
  "news_results": [
    {
      "title": "Nvidia board is not considering bringing Jensen Huang back as CEO, source tells CNBC",
      "link": "https://www.cnbc.com/2026/11/16/nvidia-ceo-jensen-huang.html",
      "source": "CNBC",
      ...
    },
    ...
  ],
  ...
}

Example with spellcheck: 0

With spellcheck set to 0, the API searches for the query as typed, like the Search instead for link of Brave News.

Example with spellcheck: 0

JSON Example

{
  ...
  "search_parameters": {
    "engine": "brave_news",
    "q": "nvidea",
    "country": "us",
    "language": "en",
    "spellcheck": "0"
  },
  "search_information": {
    "news_results_state": "Results for exact spelling"
  },
  "news_results": [
    {
      "title": "What Does 'Nvidia' Actually Mean? - AOL",
      "link": "https://aol.com/articles/does-nvidia-actually-mean-160500000.html",
      "source": "AOL",
      ...
    },
    ...
  ],
  ...
}

Example with offset: 1

With offset set to 1, the API returns the second page of Brave News, its last one. serpapi_pagination.next is only present when Brave News has a next page.

Example with offset: 1

JSON Example

{
  ...
  "search_parameters": {
    "engine": "brave_news",
    "q": "bitcoin",
    "country": "us",
    "language": "en",
    "offset": 1
  },
  "news_results": [
    {
      "title": "CZ denies Binance sold crypto as Bitcoin rebounds from lows",
      "link": "https://cryptobriefing.com/cz-denies-binance-sold-crypto-bitcoin-rebounds/",
      "snippet": "CZ denies Binance sold crypto as Bitcoin rebounds above $64,000 after hitting its lowest level since July amid $2 billion in liquidations.",
      "source": "Crypto Briefing",
      "date": "1 day ago",
      "thumbnail": "https://imgs.search.brave.com/MXUI95P5M-RuIKW95W8EaWleyYd1KEr8-kIAsYPp6UY/rs:fit:200:200:1:0/g:ce/aHR0cHM6Ly9zdGF0/aWMuY3J5cHRvYnJp/ZWZpbmcuY29tL3dw/LWNvbnRlbnQvdXBs/b2Fkcy8yMDI2LzEx/LzE1MTcwMTU2L2xp/YnJhcnktY3otZGVu/aWVzLWJpbmFuY2Ut/c29sZC1jcnlwdG8t/YXMtYml0Y29pbi1y/ZWJvdW5kcy1mcm9t/LWwtODAweDQ1MC5w/bmc",
      "favicon": "https://imgs.search.brave.com/FO34VukAiWSY5VwFH0fvy1lIqKz2pqnn6U3fnEyb51E/rs:fit:32:32:1:0/g:ce/aHR0cDovL2Zhdmlj/b25zLnNlYXJjaC5i/cmF2ZS5jb20vaWNv/bnMvMWJhZGQ1MWM5/N2RlZmZiYWZiYTFh/NDQ1YmY2M2NkYWZk/NzI1YjE0NWYzNGMz/ODkwZjcyMDdlYTgw/ZDZlOTYxZC9jcnlw/dG9icmllZmluZy5j/b20v"
    },
    ...
  ],
  "serpapi_pagination": {
    "current": 2,
    "previous": "https://serpapi.com/search.json?country=us&engine=brave_news&language=en&q=bitcoin"
  }
}

JSON structure overview

{
  ...
  "search_information": {
    "spelling_fix": "String - Query that Brave News searched for instead of the misspelled one. (Ex. nvidia for nvidea)",
    "news_results_state": "String - 'Results for exact spelling', 'Showing results for fixed spelling' when Brave News searched for the spelling fix, or 'Fully empty' when there are no results."
  },
  "news_results": [
    {
      "title": "String - Title of the article.",
      "link": "String - Link to the article.",
      "snippet": "String - Snippet of the article, as cut by Brave News.",
      "source": "String - Name of the website of the article (Ex. The Guardian), or its domain when Brave News has no name for it.",
      "date": "String - Publication date of the article, as shown by Brave News, in the language of the language parameter. Missing when Brave News has no date for it. (Ex. 2 days ago, or September 16, 2026)",
      "thumbnail": "String - Link to the thumbnail of the article, served by Brave. Missing when the article has no thumbnail.",
      "favicon": "String - Link to the favicon of the website of the article, served by Brave."
    },
    ...
  ],
  "serpapi_pagination": {
    "current": "Integer - Current page.",
    "previous": "String - SerpApi link to the previous page.",
    "next": "String - SerpApi link to the next page. Missing when Brave News has no more results."
  }
}