Brave Search News Search

5 credits/call
ae_bravesearch_news_search

Find real-time news articles from trusted sources worldwide. Filter results by freshness (e.g., last 24 hours), country, and language to track breaking news or monitor media coverage.

NewsSearch
5 credits/call

Pricing

5 credits/call
ConditionCharge
Each call5 credits/call

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
qstringYesSearch query.—
countintegerNoNumber of results, up to 50.—
offsetintegerNoPagination offset, 0-based, up to 9.—
countrystringNoCountry code.—
gogglesstringNoOptional goggles filter.—
ui_langstringNoUI language locale, typically in the form <language_code>-<country_code>, for example en-US. Use a Brave-supported UI locale value.—
freshnessenum (pd | pw | pm | py | YYYY-MM-DDtoYYYY-MM-DD)NoFreshness filter. Use pd (last 24 hours), pw (last 7 days), pm (last 31 days), py (last year), or a custom range formatted as YYYY-MM-DDtoYYYY-MM-DD.—
search_langenum (ar | eu | bn | bg | ca | zh-hans | zh-hant | hr | cs | da | nl | en | en-gb | et | fi | fr | gl | de | el | gu | he | hi | hu | is | it | jp | kn | ko | lv | lt | ms | ml | mr | nb | pl | pt-br | pt-pt | pa | ro | ru | sr | sk | sl | es | sv | ta | te | th | tr | uk | vi)NoSearch language. Use one of Brave's exact supported locale codes, for example zh-hans or zh-hant. Values like zh or zh-CN are not accepted.—
extra_snippetsbooleanNoWhether to include extra snippets.—

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_bravesearch_news_search' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "count": 15,
    "country": "CN",
    "freshness": "pd",
    "q": "江苏 售电 电力市场 电价 政策",
    "search_lang": "zh-hans"
  }
}'
Response exampleresponse.json
JSONPartial content
{
  "query": {
    "original": "江苏 售电 电力市场 电价 政策",
    "show_strict_warning": false,
    "spellcheck_off": false
  },
  "results": [
    {
      "age": "3 hours ago",
      "description": "新泽西州公用事业委员会...西洋城电力涨17.23%,Rockland电气涨18.18%。 · 马里兰那边测算下来,每月多14到18美元;华盛顿特区每月多10美元;俄亥俄不少用户在同一个月看到供电价格跳了10%到35%。 · 美国能源信息署的数字是,2026年1到7月,特区居民平均电价同比涨了...",
      "extra_snippets": [
        "新泽西州公用事业委员会估算,2025年6月起,PSE&G用户平均账单涨17.24%,JCP&L涨20.20%,大西洋城电力涨17.23%,Rockland电气涨18.18%。 · 马里兰那边测算下来,每月多14到18美元;华盛顿特区每月多10美元;俄亥俄不少用户在同一个月看到供电价格跳了10%到35%。 · 美国能源信息署的数字是,2026年1到7月,特区居民平均电价同比涨了17.8%。"
      ],
      "title": "乌兰察布,才是AI数据中心的正确答案?_投资界",
      "type": "news_result",
      "url": "https://news.pedaily.cn/202611/571499.shtml"
    }
  ],
  "type": "news"
}

This example shows part of the response. Copied content is valid JSON.