{"uid":"cap_CTcRbK5g1WW0jkwPbGK54","slug":"aisa-mpp-data-apis-brave-video-search-4efc3688","name":"Brave Video Search","description":"<!-- aisa-pricing:start -->\nPublished reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/brave/videos/search?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","title":"VideoSearchParameters","required":["q"],"properties":{"q":{"type":"string","title":"Q","maxLength":400,"minLength":1,"description":"The user’s search query term. Query can not be empty. Maximum of 400 characters and 50 words in the query."},"count":{"type":"integer","title":"Count","default":20,"maximum":50,"minimum":1,"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."},"offset":{"type":"integer","title":"Offset","default":0,"maximum":9,"minimum":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."},"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"],"type":"string","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 <code>ALL</code> for worldwide."},"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"],"type":"string","title":"MarketCodes"},{"default":"en-US"}],"description":"User interface language preferred in response. Usually of the format <code>&lt;language_code&gt;-&lt;country_code&gt;</code>. For more, see <a href=\"https://www.rfc-editor.org/rfc/rfc9110.html#name-accept-language\">RFC 9110</a>."},"freshness":{"type":"string","title":"Freshness","default":"","examples":["","pm","2022-04-01to2022-07-30"],"description":"<p>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:</p>\n<ul>\n<li><strong>pd</strong> - Pages aged 24 hours or less.</li>\n<li><strong>pw</strong> - Pages aged 7 days or less.</li>\n<li><strong>pm</strong> - Pages aged 31 days or less.</li>\n<li><strong>py</strong> - Pages aged 365 days or less.</li>\n<li><strong>YYYY-MM-DDtoYYYY-MM-DD</strong> - A custom date range is also supported by specifying start and end dates e.g. <code>2022-04-01to2022-07-30</code>.</li>\n</ul>"},"operators":{"type":"boolean","title":"Operators","default":true,"examples":["",true,false],"description":"Whether to apply search operators."},"safesearch":{"allOf":[{"enum":["off","moderate","strict"],"type":"string","title":"SafeSearch"},{"default":"moderate"}],"title":"Safe search","examples":["","off","moderate","strict"],"description":"<p>Filters search results for adult content. The following values are supported:</p>\n<ul>\n<li><strong>off</strong> - No filtering is done.</li>\n<li><strong>moderate</strong> - Filters explicit content, like images and videos, but allows adult domains in the search results.</li>\n<li><strong>strict</strong> - Drops all adult content from search results.</li>\n</ul>"},"spellcheck":{"type":"boolean","title":"Spellcheck","default":true,"examples":["",true,false],"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."},"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"],"type":"string","title":"Language"},{"default":"en"}],"description":"The search language preference. The 2 or more character language code for which the search results are provided."},"include_fetch_metadata":{"type":"boolean","title":"Include Fetch Metadata","default":false,"examples":["",true,false],"description":"Include fetch metadata."}}},"responseSchema":{"type":"object","title":"VideoSearchApiResponse","required":["query","extra"],"properties":{"type":{"enum":["videos"],"type":"string","const":"videos","title":"Type","default":"videos"},"extra":{"type":"object","title":"Extra","properties":{"might_be_offensive":{"type":"boolean","title":"Might Be Offensive","default":false,"description":"Indicates whether the video search results might contain offensive content."}}},"query":{"type":"object","title":"Query","required":["original"],"properties":{"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."},"original":{"type":"string","title":"Original","description":"The original query that was requested."},"spellcheck_off":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Spellcheck Off","description":"Whether the spellchecker is enabled or disabled."},"search_operators":{"anyOf":[{"type":"object","title":"SearchOperators","properties":{"sites":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Sites","description":"List of site domains extracted from site: operators."},"applied":{"type":"boolean","title":"Applied","default":false,"description":"Whether search operators were applied to the query."},"cleaned_query":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Cleaned Query","description":"The query after search operators have been processed."}}},{"type":"null"}],"description":"Search operators applied to the query."},"show_strict_warning":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Show Strict Warning","description":"The value is <code>true</code> if the lack of results is due to a <code>strict</code> safesearch setting. Adult content relevant to the query was found, but was blocked by safesearch."}}},"results":{"type":"array","items":{"type":"object","title":"VideoResult","required":["url","title"],"properties":{"age":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age","description":"A human-readable representation of the video’s age. For example, <code>2 days ago</code>."},"url":{"type":"string","title":"Url","description":"The source URL of the video."},"type":{"enum":["video_result"],"type":"string","const":"video_result","title":"Type","default":"video_result","description":"The type of video search API result. The value is always <code>video_result</code>."},"title":{"type":"string","title":"Title","description":"The title of the video."},"video":{"anyOf":[{"type":"object","title":"VideoData","properties":{"tags":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Tags","description":"A list of tags relevant to the video."},"views":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Views","description":"The number of views of the video."},"author":{"anyOf":[{"$ref":"#/components/schemas/brave_search_252245bec325__ResponseB91D37C29Ffe_app__models__products__search__v1__videos__Profile"},{"type":"null"}],"description":"A profile associated with the video."},"creator":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Creator","description":"The creator of the video."},"duration":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Duration","description":"A time string representing the duration 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."}}},{"type":"null"}],"description":"Metadata for the video."},"meta_url":{"anyOf":[{"type":"object","title":"MetaUrl","properties":{"path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Path","description":"The hierarchical path of the URL useful as a display string."},"netloc":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Netloc","description":"The network location part extracted from the URL."},"scheme":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Scheme","description":"The protocol scheme extracted from the URL."},"favicon":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Favicon","description":"The favicon used for the URL."},"hostname":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hostname","description":"The lowercased domain name extracted from the URL."}}},{"type":"null"}],"description":"Aggregated information on the URL associated with the video search result."},"page_age":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Age","description":"The page’s date, based on its published or last modified date."},"thumbnail":{"anyOf":[{"type":"object","title":"Thumbnail","required":["src"],"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":"null"}],"description":"The thumbnail for the video."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The description for the video."},"page_fetched":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Page Fetched","description":"The ISO date time when the page was last fetched. The format is <code>YYYY-MM-DDTHH:MM:SSZ</code>."},"fetched_content_timestamp":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Fetched Content Timestamp","description":"The timestamp when the content was fetched."}}},"title":"Results","default":[],"description":"The list of video results for the given query."}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_EkISA_ZgAPWSQ6Cte7lM_","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Search the web for videos using Brave Search, returning ranked video results with metadata for a given query.","exampleAgentPrompt":"Search for videos about 'how to make sourdough bread' and give me the top 10 results from the US.","exampleUseCases":[{"title":"Tutorial video discovery for learners","prompt":"Find me the top 5 videos on YouTube and the web explaining how to set up a Docker container — I want beginner-friendly tutorials."},{"title":"News video search by topic","prompt":"Search for recent video news coverage about the 2024 US presidential election results and show me 20 results."},{"title":"Product demo video lookup","prompt":"Find videos demonstrating the features of the iPhone 16 Pro — I want to see hands-on reviews and demos, show me 15 results from the US."}],"resultDescription":"Returns a structured response containing a list of video results (titles, URLs, thumbnails, durations, source domains), query metadata (original query, spellcheck-corrected version, search operators applied), and flags such as whether results might be offensive. Pagination is supported via count and offset fields.","failureModes":["Empty query string returns validation error (q is required and must be non-empty)","Query exceeding 400 characters or 50 words is rejected","Offset greater than 9 is rejected","Count greater than 50 is rejected","Unsupported country or language code returns an error","Low or no results for niche or highly specific queries","Offensive content filtered depending on safesearch settings"],"whenToPreferThis":"Choose this endpoint when you specifically need video results (not general web pages, images, or news articles) from Brave Search. It is ideal for agents that need to surface video tutorials, clips, or media content and want a privacy-friendly alternative to Google or YouTube search APIs. Prefer this over general web search endpoints when the user explicitly wants video content or when video is the most appropriate format for the user's information need.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:49.730Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-brave-video-search-5e94b9ec"}