{"uid":"cap_F7qcOEKRyAeGY7YVyc20N","slug":"aisa-mpp-data-apis-brave-news-search-via-aisa-mpp-10612bd8","name":"Brave News Search via AIsa MPP","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/news/search?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["q"],"properties":{"q":{"type":"string","title":"The user's search query term.","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."},"goggles":{"anyOf":[{"type":"string"},{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Goggles","description":"Goggles act as a custom re-ranking on top of Brave’s search index. The parameter supports both a url where the Goggle is hosted or the definition of the Goggle. For more details, see the <a href=\"/documentation/resources/goggles\">Goggles documentation</a>. The parameter can be a single Goggle or a list of up to 3 Goggles."},"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":"strict"}],"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> - Filter out explicit content.</li>\n<li><strong>strict</strong> - Filter out explicit and suggestive content.</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."},"extra_snippets":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Extra Snippets","description":"A snippet is an excerpt from a page you get as a result of the query, and extra_snippets allow you to get up to 5 additional, alternative excerpts."},"include_fetch_metadata":{"type":"boolean","title":"Include Fetch Metadata","default":false,"examples":["",true,false],"description":"Include fetch metadata."}}},"responseSchema":{"type":"object","title":"NewsSearchApiResponse","required":["query"],"properties":{"type":{"enum":["news"],"type":"string","const":"news","title":"Type","default":"news"},"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":"NewsResult","required":["title","url"],"properties":{"age":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Age","description":"A human-readable representation of the news article’s age. For example, <code>2 days ago</code>."},"url":{"type":"string","title":"Url","description":"The source URL of the news article."},"type":{"enum":["news_result"],"type":"string","const":"news_result","title":"Type","default":"news_result","description":"The type of news search API result. The value is always <code>news_result</code>."},"icons":{"anyOf":[{"type":"array","items":{"type":"object","title":"PostprocessedIcon","required":["href","sizes","rel","type","ext"],"properties":{"ext":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ext"},"rel":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Rel"},"href":{"type":"string","title":"Href"},"type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Type"},"sizes":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Sizes"}}}},{"type":"null"}],"title":"Icons","description":"Icons associated with the news result."},"title":{"type":"string","title":"Title","description":"The title of the news article."},"profile":{"anyOf":[{"type":"object","title":"Profile","required":["name","url"],"properties":{"img":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img","description":"The served image URL representing the profile."},"url":{"type":"string","title":"Url","description":"The original URL where the profile is available."},"name":{"type":"string","title":"Name","description":"The name of the profile."},"long_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Name","description":"The long name of the profile."}},"description":"A profile of an entity."},{"type":"null"}],"description":"A profile associated with the web page."},"breaking":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Breaking","description":"Whether the result includes breaking news."},"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 news 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 news article."},"original":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Original","description":"The original URL of the thumbnail associated with the news article."}}},{"type":"null"}],"description":"The thumbnail for the news article."},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description","description":"The description for the news article."},"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>."},"extra_snippets":{"anyOf":[{"type":"array","items":{"type":"string"}},{"type":"null"}],"title":"Extra Snippets","description":"A list of extra alternate snippets for the news search result."},"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 news 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_BiSis5nK_DwP6og6lCdln","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 for recent news articles using Brave's news search index, with country filtering and pagination, via pay-per-request access.","exampleAgentPrompt":"Search for the latest news about the Federal Reserve interest rate decisions, give me 10 results from the US.","exampleUseCases":[{"title":"Breaking financial news lookup","prompt":"Find the latest 15 news articles about Tesla earnings from the US — I want to see what's been reported in the last few days."},{"title":"Country-specific news monitoring","prompt":"Search for recent news about the UK general election results, filter to GB, and give me the top 20 articles."},{"title":"Topic research for investment decisions","prompt":"Get me recent news articles about semiconductor supply chain disruptions — I need 10 results to understand what's happening in the market right now."}],"resultDescription":"Returns a JSON object with the original query, optional spellcheck/altered query info, and an array of news results each containing title, URL, and article age metadata. Up to 50 results per request, paginated via count and offset parameters.","failureModes":["Empty query string returns validation error","Query exceeding 400 characters or 50 words is rejected","Offset greater than 9 is rejected","Fewer results than requested if Brave index lacks sufficient matching news","Unsupported country code causes error","Network timeout if Brave upstream is slow"],"whenToPreferThis":"Choose this endpoint when you need fresh, real-world news articles indexed by Brave Search, especially when country-specific news filtering or pagination is required. Prefer this over general web search endpoints when the user explicitly wants news coverage rather than web pages, and over social media endpoints when you need structured article titles and URLs from journalistic sources.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:55.219Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-brave-news-search-via-aisa-mpp-10612bd8"}