---
title: "Performs a video search using the Brave Search API, retrieving video results with detailed metadata and thumbnails."
method: POST
path: "/videoSearch"
---

# Performs a video search using the Brave Search API, retrieving video results with detailed metadata and thumbnails.

`POST /videoSearch`

The videoSearch function allows users to search for videos using the Brave Search API. It provides a wide range of customizable search parameters, including query, country, language, result count, and various filters. The function returns detailed video results including metadata, thumbnails, and related information.

## Request body

- object
  - `body` object — Body of the videoSearch sls call
    - `arguments` object, required — An object containing all the search parameters for the video search.
      - `q` string, required — The search query (max 400 characters, 50 words).
      - `country` string — 2-letter country code.
      - `search_lang` string — Search language.
      - `ui_lang` string — UI language.
      - `count` integer — Number of results (1-20).
      - `offset` integer — Offset for pagination (0-9).
      - `safesearch` 'off' | 'moderate' | 'strict' — Safe search level.
      - `freshness` union — Freshness of results.
        - 'pd' | 'pw' | 'pm' | 'py' — Predefined freshness options
        - string — Custom date range in format 'YYYY-MM-DDtoYYYY-MM-DD'
      - `text_decorations` boolean — Include decoration markers.
      - `spellcheck` boolean — Enable spellchecking.
      - `result_filter` string — Comma-separated list of result types.
      - `goggles` string[] — Goggle definitions for custom re-ranking.
      - `units` 'metric' | 'imperial' — Units for measurements.
    - `constructor` 'createBraveSDK' — Name of the constructor to use.

## Response `200`

Successful video search response

- object
  - `type` 'videos'
  - `query` object
    - `original` string
    - `altered` string
    - `cleaned` string
    - `spellcheck_off` boolean
    - `show_strict_warning` boolean
  - `results` object[]
    - `type` 'video_result'
    - `url` string
    - `title` string
    - `description` string
    - `age` string
    - `page_age` string
    - `page_fetched` string
    - `thumbnail` object
      - `src` string
      - `width` integer
      - `height` integer
    - `video` object
      - `duration` string
      - `views` string
      - `creator` string
      - `publisher` string
      - `tags` string[]
      - `author` object
      - `requires_subscription` boolean
    - `meta_url` object
      - `source` string
      - `domain` string

## Other responses

- `400` — Bad request
- `500` — Internal server error

---

[API](https://skmtc.net/microfox-ai/apis/brave-search.md) · [All operations](https://skmtc.net/microfox-ai/apis/brave-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/microfox-ai/brave-search/versions/2284eaa411cf/schema)