Brave Search Video Search
5 credits/call
ae_bravesearch_video_search
Search for videos across the web, including tutorials, news clips, and entertainment. Filter results by upload date, country, language, and safe search settings.
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. | — |
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. | — |
spellcheck | boolean | No | Whether spellcheck is enabled. | — |
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. | — |
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_video_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"count": 20,
"country": "CN",
"q": "柴油发电机组 开架式 静音式 集装箱式",
"safesearch": "off",
"search_lang": "zh-hans"
}
}'Response exampleresponse.json
{
"extra": {
"might_be_offensive": false
},
"query": {
"original": "柴油发电机组 开架式 静音式 集装箱式",
"show_strict_warning": false,
"spellcheck_off": false
},
"results": [
{
"age": "November 9, 2017",
"description": "AboutPressCopyrightContact usCreatorsAdvertiseDevelopersImpressumNetzDG TransparenzberichtNetzDG ComplaintsCancel MembershipsTermsPrivacyPolicy & SafetyHow YouTube worksTest new features · © 2023 Google LLC",
"meta_url": {
"favicon": "https://imgs.search.brave.com/Wg4wjE5SHAargkzePU3eSLmWgVz84BEZk1SjSglJK_U/rs:fit:32:32:1:0/g:ce/aHR0cDovL2Zhdmlj/b25zLnNlYXJjaC5i/cmF2ZS5jb20vaWNv/bnMvOTkyZTZiMWU3/YzU3Nzc5YjExYzUy/N2VhZTIxOWNlYjM5/ZGVjN2MyZDY4Nzdh/ZDYzMTYxNmI5N2Rk/Y2Q3N2FkNy93d3cu/eW91dHV",
"hostname": "www.youtube.com",
"netloc": "youtube.com",
"path": "› watch",
"scheme": "https"
},
"title": "北美开架好物大推荐 EP1 好用到哭!! - YouTube",
"type": "video_result",
"url": "https://www.youtube.com/watch?v=KZoyIoZU9M4"
}
],
"type": "videos"
}This example shows part of the response. Copied content is valid JSON.




