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.

VideoSearch
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.—
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.—
safesearchenum (off | moderate | strict)NoSafe search mode.—
spellcheckbooleanNoWhether spellcheck is enabled.—
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.—

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_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
JSONPartial content
{
  "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.