{"uid":"cap_BO_1dBaWSGORF43erCvIo","slug":"aisa-mpp-data-apis-brave-news-search-via-aisa-6585f6f1","name":"Brave News Search via AIsa","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":"POST","headers":{},"bodySchema":{"type":"object","title":"NewsSearchParameters","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_t3JEYfU5b3kxXlyTlRNb4","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, returning ranked results with titles, URLs, descriptions, and publication metadata","exampleAgentPrompt":"Search Brave News for the latest articles about the Federal Reserve interest rate decision — give me 10 results from the US.","exampleUseCases":[{"title":"Breaking news monitoring for topic","prompt":"Search Brave News for the latest headlines about the Israel-Gaza ceasefire negotiations and give me the top 15 results."},{"title":"Company earnings news lookup","prompt":"Find recent Brave News articles about Nvidia's Q2 earnings results — I want 10 results from the US."},{"title":"Country-specific tech news feed","prompt":"Pull the top 20 tech news stories from Brave News for the UK — I'm looking for recent coverage on AI regulation."}],"resultDescription":"Returns a JSON object containing the original query metadata (original, altered, cleaned versions, spell-check info) and an array of news results. Each news result includes title, URL, description, publication age, source name, thumbnail image, and relevance metadata. Up to 50 results per call, paginated via count and offset parameters.","failureModes":["Empty query string returns validation error (minLength:1)","Query exceeding 400 characters or 50 words is rejected","Offset above 9 is not supported and will return an error","Fewer results than requested may be returned for niche queries","Unsupported country code returns an error","Rate limiting or payment failure returns a non-200 status"],"whenToPreferThis":"Choose this endpoint when you need fresh, recent news articles indexed by Brave Search — especially when you want an alternative to Google-backed news APIs, need country-specific news filtering, or want to apply custom Brave Goggles re-ranking. Prefer this over general web search endpoints when the user explicitly wants news content rather than broad web results.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:52:37.090Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-brave-news-search-via-aisa-6585f6f1"}