> ## Documentation Index > Fetch the complete documentation index at: https://aisa.one/docs/llms.txt > Use this file to discover all available pages before exploring further. # Video Search ## OpenAPI ````yaml openapi/brave-search.json POST /apis/v1/brave/videos/search openapi: 3.1.0 info: description: '' title: Brave Search version: '1' x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-configured-paths: - /apis/v1/brave/images/search - /apis/v1/brave/llm/context - /apis/v1/brave/local/descriptions - /apis/v1/brave/local/place_search - /apis/v1/brave/local/pois - /apis/v1/brave/news/search - /apis/v1/brave/spellcheck/search - /apis/v1/brave/suggest/search - /apis/v1/brave/videos/search - /apis/v1/brave/web/rich - /apis/v1/brave/web/search x-aisa-document: facts_hash: bfca7fbdc322363be69051cbb659ceb6830c024f0f2f839d53c6ac80f1ac360c generator_version: '2' protocol_version: '1' schema_version: '1' composer_version: '13' response_pending: [] document_hash: sha256:43ac90d547b4acdf6817aa626a8b8339da83b049b076535c100777fdabb2bbe9 x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: brave-search x-aisa-catalogs: brave-search: title: Brave Search description: '' x-aisa-document: facts_hash: bfca7fbdc322363be69051cbb659ceb6830c024f0f2f839d53c6ac80f1ac360c generator_version: '2' protocol_version: '1' schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/brave/videos/search: post: tags: - default summary: Video Search operationId: post_any_brave_search_apis_v1_brave_videos_search parameters: - name: accept in: header required: false description: The default supported media type is application/json. schema: allOf: - type: string enum: - application/json - '*/*' title: Accept - default: application/json title: Media type description: The default supported media type is application/json. examples: - application/json deprecated: false examples: '0': value: application/json - name: api-version in: header required: false description: >- The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning. schema: anyOf: - type: string - type: 'null' title: API version description: >- The API version to use. This is denoted by the format YYYY-MM-DD. Default is the latest that is available. Read more about API versioning. deprecated: false - name: cache-control in: header required: false description: >- Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort. schema: anyOf: - type: string enum: - no-cache const: no-cache title: CacheControl - type: 'null' title: Cache control description: >- Brave Search will return cached content by default. To prevent caching set the Cache-Control header to no-cache. This is currently done as best effort. deprecated: false - name: user-agent in: header required: false description: >- The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110. schema: anyOf: - type: string - type: 'null' title: User agent description: >- The user agent originating the request. Brave search can utilize the user agent to provide a different experience depending on the device as described by the string. The user agent should follow the commonly used browser agent strings on each platform. For more information on curating user agents, see RFC 9110. deprecated: false examples: Android: value: >- Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36 description: Android iOS: value: >- Mozilla/5.0 (iPhone; CPU iPhone OS 15_5 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) CriOS/103.0.5060.63 Mobile/15E148 Safari/604.1 description: iOS macOS: value: >- Mozilla/5.0 (Macintosh; Intel Mac OS X 12_4) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36 description: macOS Windows: value: >- Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36 description: Windows requestBody: required: true description: '' content: application/json: schema: properties: q: type: string maxLength: 400 minLength: 1 title: Q description: >- The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query. search_lang: allOf: - type: string 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 - ja - 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 title: Language - default: en description: >- The search language preference. The 2 or more character language code for which the search results are provided. ui_lang: allOf: - type: string enum: - es-AR - en-AU - de-AT - nl-BE - fr-BE - pt-BR - en-CA - fr-CA - es-CL - da-DK - fi-FI - fr-FR - de-DE - el-GR - zh-HK - en-IN - en-ID - it-IT - ja-JP - ko-KR - en-MY - es-MX - nl-NL - en-NZ - no-NO - zh-CN - pl-PL - en-PH - ru-RU - en-ZA - es-ES - sv-SE - fr-CH - de-CH - zh-TW - tr-TR - en-GB - en-US - es-US title: MarketCodes - default: en-US description: >- User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110. country: allOf: - type: string enum: - AR - AU - AT - BE - BR - CA - CL - DK - FI - FR - DE - GR - HK - IN - ID - IT - JP - KR - MY - MX - NL - NZ - 'NO' - CN - PL - PT - PH - RU - SA - ZA - ES - SE - CH - TW - TR - GB - US - ALL title: SearchCountry - default: US description: >- The search query country, where the results come from. The country string is limited to 2 character country codes of supported countries or ALL for worldwide. safesearch: allOf: - type: string enum: - 'off' - moderate - strict title: SafeSearch - default: moderate title: Safe search description: >-

Filters search results for adult content. The following values are supported:

examples: - '' - 'off' - moderate - strict count: type: integer maximum: 50 minimum: 1 title: Count description: >- The number of search results returned in response. The maximum is 50. The actual number delivered may be less than requested. Combine this parameter with offset to paginate search results. default: 20 offset: type: integer maximum: 9 minimum: 0 title: Offset description: >- The zero based offset that indicates number of search results per page (count) to skip before returning the result. The maximum is 9. The actual number delivered may be less than requested based on the query. In order to paginate results use this parameter together with count. For example, if your user interface displays 20 search results per page, set count to 20 and offset to 0 to show the first page of results. To get subsequent pages, increment offset by 1 (e.g. 0, 1, 2). The results may overlap across multiple pages. default: 0 spellcheck: type: boolean title: Spellcheck description: >- Whether to spell check the provided query. If the spellchecker is enabled, the modified query is always used for search. The modified query can be found in altered key from the query response model. default: true examples: - '' - true - false freshness: type: string title: Freshness description: >-

Filters search results by page age. The age of a page is determined by the most relevant date reported by the content, such as its published or last modified date. The following values are supported:

default: '' examples: - '' - pm - 2022-04-01to2022-07-30 include_fetch_metadata: type: boolean title: Include Fetch Metadata description: Include fetch metadata. default: false examples: - '' - true - false operators: type: boolean title: Operators description: Whether to apply search operators. default: true examples: - '' - true - false type: object required: - q title: VideoSearchParameters responses: '200': description: Successful Response content: application/json: schema: $ref: >- #/components/schemas/ResponseE3Baaa015480_VideoSearchApiResponse default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: ResponseE3Baaa015480_VideoSearchApiResponse: properties: type: type: string enum: - videos const: videos title: Type default: videos query: $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__videos__Query description: Video search query string. results: items: $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__videos__VideoResult type: array title: Results description: The list of video results for the given query. default: [] extra: $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__videos__Extra description: Additional information about the video search results. type: object required: - query - extra title: VideoSearchApiResponse ResponseE3Baaa015480_app__models__products__search__v1__videos__Query: properties: original: type: string title: Original description: The original query that was requested. altered: anyOf: - type: string - type: 'null' title: Altered description: >- The altered query by the spellchecker. This is the query that is used to search if any. cleaned: anyOf: - type: string - type: 'null' title: Cleaned description: >- The cleaned normalized query by the spellchecker. This is the query that is used to search if any. spellcheck_off: anyOf: - type: boolean - type: 'null' title: Spellcheck Off description: Whether the spellchecker is enabled or disabled. show_strict_warning: anyOf: - type: boolean - type: 'null' title: Show Strict Warning description: >- The value is true if the lack of results is due to a strict safesearch setting. Adult content relevant to the query was found, but was blocked by safesearch. search_operators: anyOf: - $ref: '#/components/schemas/ResponseE3Baaa015480_SearchOperators' - type: 'null' description: Search operators applied to the query. type: object required: - original title: Query ResponseE3Baaa015480_app__models__products__search__v1__videos__VideoResult: properties: type: type: string enum: - video_result const: video_result title: Type description: >- The type of video search API result. The value is always video_result. default: video_result url: type: string title: Url description: The source URL of the video. title: type: string title: Title description: The title of the video. description: anyOf: - type: string - type: 'null' title: Description description: The description for the video. age: anyOf: - type: string - type: 'null' title: Age description: >- A human-readable representation of the video’s age. For example, 2 days ago. page_age: anyOf: - type: string - type: 'null' title: Page Age description: The page’s date, based on its published or last modified date. page_fetched: anyOf: - type: string - type: 'null' title: Page Fetched description: >- The ISO date time when the page was last fetched. The format is YYYY-MM-DDTHH:MM:SSZ. fetched_content_timestamp: anyOf: - type: integer - type: 'null' title: Fetched Content Timestamp description: The timestamp when the content was fetched. video: anyOf: - $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__videos__VideoData - type: 'null' description: Metadata for the video. meta_url: anyOf: - $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__videos__MetaUrl - type: 'null' description: >- Aggregated information on the URL associated with the video search result. thumbnail: anyOf: - $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__videos__Thumbnail - type: 'null' description: The thumbnail for the video. type: object required: - url - title title: VideoResult ResponseE3Baaa015480_app__models__products__search__v1__videos__Extra: properties: might_be_offensive: type: boolean title: Might Be Offensive description: >- Indicates whether the video search results might contain offensive content. default: false type: object title: Extra ResponseE3Baaa015480_SearchOperators: properties: applied: type: boolean title: Applied description: Whether search operators were applied to the query. default: false cleaned_query: anyOf: - type: string - type: 'null' title: Cleaned Query description: The query after search operators have been processed. sites: anyOf: - items: type: string type: array - type: 'null' title: Sites description: 'List of site domains extracted from site: operators.' type: object title: SearchOperators ResponseE3Baaa015480_app__models__products__search__v1__videos__VideoData: properties: duration: anyOf: - type: string - type: 'null' title: Duration description: A time string representing the duration of the video. views: anyOf: - type: integer - type: 'null' title: Views description: The number of views of the video. creator: anyOf: - type: string - type: 'null' title: Creator description: The creator of the video. publisher: anyOf: - type: string - type: 'null' title: Publisher description: The publisher of the video. requires_subscription: anyOf: - type: boolean - type: 'null' title: Requires Subscription description: Whether the video requires a subscription. tags: anyOf: - items: type: string type: array - type: 'null' title: Tags description: A list of tags relevant to the video. author: anyOf: - $ref: >- #/components/schemas/ResponseE3Baaa015480_app__models__products__search__v1__videos__Profile - type: 'null' description: A profile associated with the video. type: object title: VideoData ResponseE3Baaa015480_app__models__products__search__v1__videos__MetaUrl: properties: scheme: anyOf: - type: string - type: 'null' title: Scheme description: The protocol scheme extracted from the URL. netloc: anyOf: - type: string - type: 'null' title: Netloc description: The network location part extracted from the URL. hostname: anyOf: - type: string - type: 'null' title: Hostname description: The lowercased domain name extracted from the URL. favicon: anyOf: - type: string - type: 'null' title: Favicon description: The favicon used for the URL. path: anyOf: - type: string - type: 'null' title: Path description: The hierarchical path of the URL useful as a display string. type: object title: MetaUrl ResponseE3Baaa015480_app__models__products__search__v1__videos__Thumbnail: properties: src: type: string title: Src description: The served URL of the thumbnail associated with the video. original: anyOf: - type: string - type: 'null' title: Original description: The original URL of the thumbnail associated with the video. type: object required: - src title: Thumbnail ResponseE3Baaa015480_app__models__products__search__v1__videos__Profile: properties: name: type: string title: Name description: The name of the profile. url: type: string title: Url description: The original URL where the profile is available. long_name: anyOf: - type: string - type: 'null' title: Long Name description: The long name of the profile. img: anyOf: - type: string - type: 'null' title: Img description: The served image URL representing the profile. type: object required: - name - url title: Profile securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.