Brave Search Web Search
5 credits/call
ae_bravesearch_web_search
Search the web for pages, local businesses, and real-time data like weather, stocks, or sports scores. Filter by date, location, and language to find relevant information.
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 20. | — |
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. | — |
safesearch | enum (off | moderate | strict) | No | Safe search mode. | — |
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. | — |
enable_rich_callback | boolean | No | Enable rich callback features. | — |
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_web_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"count": 5,
"q": "\"m4OGmuAGjb9\" 淘宝 店铺",
"search_lang": "zh-hans"
}
}'Response exampleresponse.json
{
"mixed": {
"main": [],
"side": [],
"top": [],
"type": "mixed"
},
"query": {
"bad_results": true,
"city": "",
"cleaned": "m4OGmuAGjb9 淘宝 店铺",
"country": "us",
"header_country": "",
"is_navigational": true
},
"type": "search"
}This example shows part of the response. Copied content is valid JSON.
Guides using this tool
See how this tool fits into real workflows




