> ## 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. > ## Agent Instructions > - Base URLs: models `https://api.aisa.one/v1` (Gemini GenerateContent: `https://api.aisa.one/v1beta`); data APIs `https://api.aisa.one/apis/v1`. The `servers` of each operation in https://aisa.one/openapi.yaml is authoritative. > - Auth: `Authorization: Bearer $AISA_API_KEY`. Never print, log, or commit the key. > - MCP (preferred for agents): `https://mcp.aisa.one/mcp`, signed in with OAuth, so there is no key to paste. > - Agent Skill: `npx skills add AIsa-team/agent-skills --skill aisa`. Fallback with the AIsa CLI: `aisa skills install aisa`. > - Spending: docs, https://aisa.one/models, https://aisa.one/api, `/v1/models`, and MCP `search`, `list_categories`, `get_details`, `batch_quote`, and the `account` operation are free. Quote the exact calls before running them (MCP `batch_quote`, CLI `aisa quote --json`). If the quote reports `auto_execute_eligible: true`, run it unless the user set a tighter limit or asked only for a quote. Otherwise, tell the user in one message the planned calls, the quoted price, and a total USD budget for the task, then wait for approval. Direct HTTP calls follow the stricter rule at https://aisa.one/docs/get-started/cli.md#direct-http-fallback. Do not make paid calls to test availability. Full rule: https://aisa.one/llms.txt # Video Search > Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ. ## Request contract * **Method and path:** POST /apis/v1/brave/videos/search * **Availability:** enabled * **Request URL template:** [https://api.aisa.one/apis/v1/brave/videos/search](https://api.aisa.one/apis/v1/brave/videos/search) * **accept:** header; optional * **api-version:** header; optional * **cache-control:** header; optional * **user-agent:** header; optional * **Runtime facts:** 1a33626eaeae62e76e9c639775194a0fb4a6aa9a06aa3c4da50f9205e06ac5e3 [Complete OpenAPI definition](https://aisa.one/docs/openapi/brave-search.json) Effective request and pricing declaration (including authentication and referenced schemas): ```json theme={null} { "operationId": "post_any_brave_search_apis_v1_brave_videos_search", "method": "POST", "path": "/apis/v1/brave/videos/search", "servers": [ { "url": "https://api.aisa.one" } ], "parameters": [ { "deprecated": false, "description": "The default supported media type is application/json.", "examples": { "0": { "value": "application/json" } }, "in": "header", "name": "accept", "required": false, "schema": { "allOf": [ { "enum": [ "application/json", "*/*" ], "title": "Accept", "type": "string" }, { "default": "application/json" } ], "description": "The default supported media type is application/json.", "examples": [ "application/json" ], "title": "Media type" } }, { "deprecated": 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.", "in": "header", "name": "api-version", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "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.", "title": "API version" } }, { "deprecated": 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.", "in": "header", "name": "cache-control", "required": false, "schema": { "anyOf": [ { "const": "no-cache", "enum": [ "no-cache" ], "title": "CacheControl", "type": "string" }, { "type": "null" } ], "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.", "title": "Cache control" } }, { "deprecated": 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.", "examples": { "Android": { "description": "Android", "value": "Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36" }, "Windows": { "description": "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" }, "iOS": { "description": "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" }, "macOS": { "description": "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" } }, "in": "header", "name": "user-agent", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "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.", "title": "User agent" } } ], "security": [ { "bearerAuth": [] } ], "requestBody": { "content": { "application/json": { "schema": { "properties": { "count": { "default": 20, "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.", "maximum": 50, "minimum": 1, "title": "Count", "type": "integer" }, "country": { "allOf": [ { "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", "type": "string" }, { "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." }, "freshness": { "default": "", "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:

\n", "examples": [ "", "pm", "2022-04-01to2022-07-30" ], "title": "Freshness", "type": "string" }, "include_fetch_metadata": { "default": false, "description": "Include fetch metadata.", "examples": [ true, false ], "title": "Include Fetch Metadata", "type": "boolean" }, "offset": { "default": 0, "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.", "maximum": 9, "minimum": 0, "title": "Offset", "type": "integer" }, "operators": { "default": true, "description": "Whether to apply search operators.", "examples": [ true, false ], "title": "Operators", "type": "boolean" }, "q": { "description": "The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query.", "maxLength": 400, "minLength": 1, "title": "Q", "type": "string" }, "safesearch": { "allOf": [ { "enum": [ "off", "moderate", "strict" ], "title": "SafeSearch", "type": "string" }, { "default": "moderate" } ], "description": "

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

\n", "examples": [ "off", "moderate", "strict" ], "title": "Safe search" }, "search_lang": { "allOf": [ { "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", "type": "string" }, { "default": "en" } ], "description": "The search language preference. The 2 or more character language code for which the search results are provided." }, "spellcheck": { "default": true, "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.", "examples": [ true, false ], "title": "Spellcheck", "type": "boolean" }, "ui_lang": { "allOf": [ { "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", "type": "string" }, { "default": "en-US" } ], "description": "User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110." } }, "required": [ "q" ], "title": "VideoSearchParameters", "type": "object" } } }, "description": "", "required": true }, "x-aisa-status": "enabled", "x-aisa-pricing": { "cost_contract": "fixed_success", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "request_snapshot" }, "components": { "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } } } ``` ## Cost and request rules Published reference price: \$0.005 USD per successful request. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar. * **Default request reference estimate (USD):** 0.005 * **Cost contract:** fixed\_success * **Published reference multiplier:** 1.0 * **Settlement evidence source:** request\_snapshot ## 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-catalogs: brave-search: description: '' title: Brave Search x-aisa-capabilities: idempotency: Idempotency-Key max_price: X-AISA-Max-Price-USD quote: header: X-AISA-Cost-Mode value: quote x-aisa-document: facts_hash: 1a33626eaeae62e76e9c639775194a0fb4a6aa9a06aa3c4da50f9205e06ac5e3 generator_version: '3' 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-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: composer_version: '26' document_hash: sha256:292f4430db3117938062bfb5fafd07080665697e3157341c3f26292cb7e5405a facts_hash: 1a33626eaeae62e76e9c639775194a0fb4a6aa9a06aa3c4da50f9205e06ac5e3 generator_version: '3' protocol_version: '1' response_pending: [] schema_version: '1' x-aisa-plans: builder: 1 display_plan: payg payg: 1 similarweb_payg: 1 team: 1 version: e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb x-aisa-provider: brave-search servers: - url: https://api.aisa.one security: - bearerAuth: [] paths: /apis/v1/brave/videos/search: post: tags: - default summary: Video Search description: >- Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ. operationId: post_any_brave_search_apis_v1_brave_videos_search parameters: - deprecated: false description: The default supported media type is application/json. examples: '0': value: application/json in: header name: accept required: false schema: allOf: - enum: - application/json - '*/*' title: Accept type: string - default: application/json description: The default supported media type is application/json. examples: - application/json title: Media type - deprecated: 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. in: header name: api-version required: false schema: anyOf: - type: string - type: 'null' 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. title: API version - deprecated: 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. in: header name: cache-control required: false schema: anyOf: - const: no-cache enum: - no-cache title: CacheControl type: string - type: 'null' 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. title: Cache control - deprecated: 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. examples: Android: description: Android value: >- Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.5060.71 Mobile Safari/537.36 Windows: description: 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 iOS: description: 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 macOS: description: 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 in: header name: user-agent required: false schema: anyOf: - type: string - type: 'null' 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. title: User agent requestBody: content: application/json: schema: properties: count: default: 20 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. maximum: 50 minimum: 1 title: Count type: integer country: allOf: - 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 type: string - 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. freshness: default: '' 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:

examples: - '' - pm - 2022-04-01to2022-07-30 title: Freshness type: string include_fetch_metadata: default: false description: Include fetch metadata. examples: - true - false title: Include Fetch Metadata type: boolean offset: default: 0 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. maximum: 9 minimum: 0 title: Offset type: integer operators: default: true description: Whether to apply search operators. examples: - true - false title: Operators type: boolean q: description: >- The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query. maxLength: 400 minLength: 1 title: Q type: string safesearch: allOf: - enum: - 'off' - moderate - strict title: SafeSearch type: string - default: moderate description: >-

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

examples: - 'off' - moderate - strict title: Safe search search_lang: allOf: - 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 type: string - default: en description: >- The search language preference. The 2 or more character language code for which the search results are provided. spellcheck: default: true 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. examples: - true - false title: Spellcheck type: boolean ui_lang: allOf: - 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 type: string - default: en-US description: >- User interface language preferred in response. Usually of the format <language_code>-<country_code>. For more, see RFC 9110. required: - q title: VideoSearchParameters type: object description: '' required: true responses: '200': content: application/json: schema: $ref: >- #/components/schemas/Response762Cca4421D2_VideoSearchApiResponse description: Successful Response default: content: application/json: schema: {} description: >- Error response; upstream passthrough responses may use provider formats components: schemas: Response762Cca4421D2_VideoSearchApiResponse: properties: extra: $ref: >- #/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__Extra description: Additional information about the video search results. query: $ref: >- #/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__Query description: Video search query string. results: default: [] description: The list of video results for the given query. items: $ref: >- #/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__VideoResult title: Results type: array type: const: videos default: videos enum: - videos title: Type type: string required: - query - extra title: VideoSearchApiResponse type: object Response762Cca4421D2_app__models__products__search__v1__videos__Extra: properties: might_be_offensive: default: false description: >- Indicates whether the video search results might contain offensive content. title: Might Be Offensive type: boolean title: Extra type: object Response762Cca4421D2_app__models__products__search__v1__videos__Query: properties: altered: anyOf: - type: string - type: 'null' description: >- The altered query by the spellchecker. This is the query that is used to search if any. title: Altered cleaned: anyOf: - type: string - type: 'null' description: >- The cleaned normalized query by the spellchecker. This is the query that is used to search if any. title: Cleaned original: description: The original query that was requested. title: Original type: string search_operators: anyOf: - $ref: '#/components/schemas/Response762Cca4421D2_SearchOperators' - type: 'null' description: Search operators applied to the query. show_strict_warning: anyOf: - type: boolean - type: 'null' 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. title: Show Strict Warning spellcheck_off: anyOf: - type: boolean - type: 'null' description: Whether the spellchecker is enabled or disabled. title: Spellcheck Off required: - original title: Query type: object Response762Cca4421D2_app__models__products__search__v1__videos__VideoResult: properties: age: anyOf: - type: string - type: 'null' description: >- A human-readable representation of the video’s age. For example, 2 days ago. title: Age description: anyOf: - type: string - type: 'null' description: The description for the video. title: Description fetched_content_timestamp: anyOf: - type: integer - type: 'null' description: The timestamp when the content was fetched. title: Fetched Content Timestamp meta_url: anyOf: - $ref: >- #/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__MetaUrl - type: 'null' description: >- Aggregated information on the URL associated with the video search result. page_age: anyOf: - type: string - type: 'null' description: The page’s date, based on its published or last modified date. title: Page Age page_fetched: anyOf: - type: string - type: 'null' description: >- The ISO date time when the page was last fetched. The format is YYYY-MM-DDTHH:MM:SSZ. title: Page Fetched thumbnail: anyOf: - $ref: >- #/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__Thumbnail - type: 'null' description: The thumbnail for the video. title: description: The title of the video. title: Title type: string type: const: video_result default: video_result description: >- The type of video search API result. The value is always video_result. enum: - video_result title: Type type: string url: description: The source URL of the video. title: Url type: string video: anyOf: - $ref: >- #/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__VideoData - type: 'null' description: Metadata for the video. required: - url - title title: VideoResult type: object Response762Cca4421D2_SearchOperators: properties: applied: default: false description: Whether search operators were applied to the query. title: Applied type: boolean cleaned_query: anyOf: - type: string - type: 'null' description: The query after search operators have been processed. title: Cleaned Query sites: anyOf: - items: type: string type: array - type: 'null' description: 'List of site domains extracted from site: operators.' title: Sites title: SearchOperators type: object Response762Cca4421D2_app__models__products__search__v1__videos__MetaUrl: properties: favicon: anyOf: - type: string - type: 'null' description: The favicon used for the URL. title: Favicon hostname: anyOf: - type: string - type: 'null' description: The lowercased domain name extracted from the URL. title: Hostname netloc: anyOf: - type: string - type: 'null' description: The network location part extracted from the URL. title: Netloc path: anyOf: - type: string - type: 'null' description: The hierarchical path of the URL useful as a display string. title: Path scheme: anyOf: - type: string - type: 'null' description: The protocol scheme extracted from the URL. title: Scheme title: MetaUrl type: object Response762Cca4421D2_app__models__products__search__v1__videos__Thumbnail: properties: original: anyOf: - type: string - type: 'null' description: The original URL of the thumbnail associated with the video. title: Original src: description: The served URL of the thumbnail associated with the video. title: Src type: string required: - src title: Thumbnail type: object Response762Cca4421D2_app__models__products__search__v1__videos__VideoData: properties: author: anyOf: - $ref: >- #/components/schemas/Response762Cca4421D2_app__models__products__search__v1__videos__Profile - type: 'null' description: A profile associated with the video. creator: anyOf: - type: string - type: 'null' description: The creator of the video. title: Creator duration: anyOf: - type: string - type: 'null' description: A time string representing the duration of the video. title: Duration publisher: anyOf: - type: string - type: 'null' description: The publisher of the video. title: Publisher requires_subscription: anyOf: - type: boolean - type: 'null' description: Whether the video requires a subscription. title: Requires Subscription tags: anyOf: - items: type: string type: array - type: 'null' description: A list of tags relevant to the video. title: Tags views: anyOf: - type: integer - type: 'null' description: The number of views of the video. title: Views title: VideoData type: object Response762Cca4421D2_app__models__products__search__v1__videos__Profile: properties: img: anyOf: - type: string - type: 'null' description: The served image URL representing the profile. title: Img long_name: anyOf: - type: string - type: 'null' description: The long name of the profile. title: Long Name name: description: The name of the profile. title: Name type: string url: description: The original URL where the profile is available. title: Url type: string required: - name - url title: Profile type: object securitySchemes: bearerAuth: scheme: bearer type: http ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.