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.
5 credits/call
Pricing
5 credits/call
| Condition | Charge |
|---|---|
| Each call | 5 credits/call |
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
q | string | Yes | Search query. | — |
count | integer | No | Number of results, up to 50. | — |
offset | integer | No | Pagination offset, 0-based, up to 9. | — |
country | string | No | Country code. | — |
goggles | string | No | Optional goggles filter. | — |
ui_lang | string | No | UI language locale, typically in the form <language_code>-<country_code>, for example en-US. Use a Brave-supported UI locale value. | — |
freshness | enum (pd | pw | pm | py | YYYY-MM-DDtoYYYY-MM-DD) | No | Freshness 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_lang | enum (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) | No | Search 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_snippets | boolean | No | Whether to include extra snippets. | — |
Invocation example
Copy the request and explore its response example.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest 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
{
"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.



