{"uid":"cap_JpqJ86WF6GRPKTe68pxP4","slug":"aisa-mpp-data-apis-brave-rich-search-header-ab39dc6c","name":"Brave Rich Search Header","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/web/rich?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","required":["callback_key"],"properties":{"callback_key":{"type":"string","title":"Callback Key","description":"The callback key to use for the rich header"}}},"responseSchema":{"type":"object","title":"RichHeaderResponse","properties":{"type":{"enum":["rich"],"type":"string","const":"rich","title":"Type","default":"rich"},"results":{"type":"array","items":{"type":"object","title":"RichResult","required":["subtype"],"properties":{"news":{"anyOf":[{"type":"object","title":"TopStoriesNewsResult","required":["is_topical","topic_id"],"properties":{"topics":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_Topic"},"title":"Topics","default":[]},"articles":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_TopStoryNewsArticle"},"title":"Articles","default":[]},"topic_id":{"type":"integer","title":"Topic Id"},"is_topical":{"type":"boolean","title":"Is Topical"}}},{"type":"null"}]},"type":{"enum":["rich"],"type":"string","const":"rich","title":"Type","default":"rich"},"stock":{"anyOf":[{"type":"object","title":"StockResult","required":["asset_info","time_range","quote","timeseries"],"properties":{"quote":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_snakepit__models__rich_header__results__stocks__v1__Quote"},"asset_info":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_AssetInfo"},"time_range":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_TickerPlotTimeRange"},"timeseries":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_StockResultTimeseries"},"exchange_info":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_ExchangeInfo"},{"type":"null"}]}}},{"type":"null"}]},"cricket":{"anyOf":[{"type":"object","title":"SportsResultCricket","required":["type","view","content"],"properties":{"type":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsDataType"},"view":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsView"},"sport":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsType","default":"cricket"},"content":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsCricketContentLeagueGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsCricketContentLeagueStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsCricketContentTeamGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsCricketContentTeamStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsCricketContentFixture"}],"title":"Content"}}},{"type":"null"}]},"subtype":{"enum":["calculator","cryptocurrency","currency","definitions","formula1","packagetracker","sports","stocks","unitconversion","unixtimestamp","weather"],"type":"string","title":"SearchAPIVertical"},"weather":{"anyOf":[{"type":"object","title":"WeatherResult","required":["location","current_time_iso","current_weather","daily","hours3"],"properties":{"daily":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_WeatherSummaryDay"},"title":"Daily"},"alerts":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_WeatherAlert"},"title":"Alerts","default":[]},"hours3":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_WeatherSummary3Hours"},"title":"Hours3"},"location":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_snakepit__models__rich_header__results__weather__v1__Location"},"current_weather":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_CurrentWeather"},"current_time_iso":{"type":"string","title":"Current Time Iso"}}},{"type":"null"}]},"baseball":{"anyOf":[{"type":"object","title":"SportsResultBaseball","required":["type","view","content"],"properties":{"type":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsDataType"},"view":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsView"},"sport":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsType","default":"baseball"},"content":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsBaseballContentLeagueGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsBaseballContentLeagueStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsBaseballContentTeamGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsBaseballContentTeamStandings"}],"title":"Content"}}},{"type":"null"}]},"currency":{"anyOf":[{"type":"object","title":"CurrencyResult","required":["conversion","timeseries"],"properties":{"conversion":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_Conversion"},"timeseries":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_Timeseries"},"supported_currencies":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_Currency"},"title":"Supported Currencies","default":[]}}},{"type":"null"}]},"football":{"anyOf":[{"type":"object","title":"SportsResultFootball","required":["type","view","content"],"properties":{"type":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsDataType"},"view":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsView"},"sport":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsType","default":"football"},"content":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsFootballContentFixture"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsFootballContentLeagueGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsFootballContentTeamStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsFootballContentLeagueStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsFootballContentTeamGames"}],"title":"Content"}}},{"type":"null"}]},"formula1":{"anyOf":[{"type":"object","title":"Formula1Result","properties":{"drivers":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_F1Standing"}},{"type":"null"}],"title":"Drivers"},"calendar":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_F1Calendar"},{"type":"null"}]},"live_race":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_F1RaceDetail"},{"type":"null"}]},"next_race":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_F1RaceDetail"},{"type":"null"}]},"constructors":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_F1Standing"}},{"type":"null"}],"title":"Constructors"},"default_view":{"anyOf":[{"enum":["schedule","drivers","constructors"],"type":"string"},{"type":"null"}],"title":"Default View"},"previous_race":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_F1RaceDetail"},{"type":"null"}]}}},{"type":"null"}]},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"provider":{"anyOf":[{"type":"object","title":"DataProvider","required":["name","url"],"properties":{"img":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Img"},"url":{"type":"string","title":"Url"},"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type","default":"external"},"long_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Long Name"}}},{"type":"null"}]},"basketball":{"anyOf":[{"type":"object","title":"SportsResultBasketball","required":["type","view","content"],"properties":{"type":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsDataType"},"view":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsView"},"sport":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsType","default":"basketball"},"content":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsBasketballContentLeagueGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsBasketballContentLeagueStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsBasketballContentTeamGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsBasketballContentTeamStandings"}],"title":"Content"}}},{"type":"null"}]},"calculator":{"anyOf":[{"type":"object","title":"CalculatorResult","required":["expression"],"properties":{"answer":{"anyOf":[{"type":"number"},{"type":"string"},{"type":"null"}],"title":"Answer"},"expression":{"type":"string","title":"Expression"}}},{"type":"null"}]},"ice_hockey":{"anyOf":[{"type":"object","title":"SportsResultIceHockey","required":["type","view","content"],"properties":{"type":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsDataType"},"view":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsView"},"sport":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsType","default":"ice_hockey"},"content":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsIceHockeyContentLeagueGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsIceHockeyContentLeagueStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsIceHockeyContentTeamGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsIceHockeyContentTeamStandings"}],"title":"Content"}}},{"type":"null"}]},"definitions":{"anyOf":[{"type":"object","title":"DefinitionsResult","required":["word","language","definitions","source_dict","attribution_text","attribution_url"],"properties":{"word":{"type":"string","title":"Word"},"language":{"type":"string","title":"Language"},"definitions":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_Definition"},"title":"Definitions"},"source_dict":{"type":"string","title":"Source Dict"},"pronounciation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pronounciation"},"attribution_url":{"type":"string","title":"Attribution Url"},"audio_available":{"type":"boolean","title":"Audio Available","default":false},"attribution_text":{"type":"string","title":"Attribution Text"}}},{"type":"null"}]},"unixtimestamp":{"anyOf":[{"type":"object","title":"UnixTimestampResult","required":["conversion"],"properties":{"conversion":{"oneOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_TsToDate"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_DateToTs"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_NowToTs"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_NowToDate"}],"title":"Conversion","discriminator":{"mapping":{"now_to_ts":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_NowToTs","date_to_ts":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_DateToTs","ts_to_date":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_TsToDate","now_to_date":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_NowToDate"},"propertyName":"intent_type"}}}},{"type":"null"}]},"cryptocurrency":{"anyOf":[{"type":"object","title":"CryptocurrencyResult","required":["intent_type","quote","timeseries","vs_currency"],"properties":{"quote":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_snakepit__models__rich_header__results__cryptocurrencies__v1__Quote"},"amount":{"anyOf":[{"type":"integer"},{"type":"number"},{"type":"null"}],"title":"Amount"},"currency":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_CurrencyForex"},{"type":"null"}]},"timeseries":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_CryptocurrencyResultTimeseries"},"intent_type":{"enum":["lookup","conversion"],"type":"string","title":"Intent Type"},"vs_currency":{"type":"string","title":"Vs Currency"},"top100_crypto":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_CryptocurrencyItem"},"title":"Top100 Crypto","default":[]},"vs_currencies":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_VsCurrency"},"title":"Vs Currencies","default":[]}}},{"type":"null"}]},"packagetracker":{"anyOf":[{"type":"object","title":"PackageTrackerResult","properties":{"matched":{"type":"array","items":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_TrackingNumber"},"title":"Matched","default":[]}}},{"type":"null"}]},"unitconversion":{"anyOf":[{"type":"object","title":"UnitConversionResult","required":["amount","from_unit","to_unit","dimensionality"],"properties":{"amount":{"type":"number","title":"Amount"},"to_unit":{"type":"string","title":"To Unit"},"from_unit":{"type":"string","title":"From Unit"},"dimensionality":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_UnitConversionDimensionality"}}},{"type":"null"}]},"american_football":{"anyOf":[{"type":"object","title":"SportsResultAmericanFootball","required":["type","view","content"],"properties":{"type":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsDataType"},"view":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsView"},"sport":{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsType","default":"american_football"},"content":{"anyOf":[{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsAmericanFootballContentLeagueGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsAmericanFootballContentLeagueStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsAmericanFootballContentTeamGames"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsAmericanFootballContentTeamStandings"},{"$ref":"#/components/schemas/brave_search_79e935d283f3__ResponseB91D37C29Ffe_SportsAmericanFootballContentFixture"}],"title":"Content"}}},{"type":"null"}]}}},"title":"Results","default":[]},"response_callback_info":{"anyOf":[{"type":"object","title":"ResponseCallbackInfo","required":["callback_key","callback_status"],"properties":{"vertical":{"anyOf":[{"enum":["calculator","cryptocurrency","currency","definitions","formula1","packagetracker","sports","stocks","unitconversion","unixtimestamp","weather"],"type":"string","title":"SearchAPIVertical"},{"type":"null"}],"description":"The vertical associated with the callback. For the full list of verticals supported see the Rich Vertical list."},"search_lang":{"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"},"callback_key":{"type":"string","title":"Callback Key","description":"The unique key for the callback."},"callback_status":{"enum":["success","failure"],"type":"string","title":"Callback Status","description":"The status of the callback operation. The value is either <code>success</code> or <code>failure</code>."}}},{"type":"null"}]}}},"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_Za2wisfqQFw8f0ra4Fgob","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":"Retrieves rich search header results from Brave Search, including structured data for stocks, news, sports, and other enriched content types.","exampleAgentPrompt":"Can you pull the Brave rich search header for AAPL so I can see the latest stock quote, price chart, and any top news stories associated with it?","exampleUseCases":[{"title":"Real-time stock quote with chart","prompt":"Pull the Brave rich search header for Tesla so I can see the current stock price, the recent price timeseries, and exchange info."},{"title":"Top news stories for a topic","prompt":"Get me the rich search header results for 'Federal Reserve interest rates' — I want to see the top news articles and stories Brave surfaces for that topic."},{"title":"Cricket match live scores","prompt":"Fetch the Brave rich header for the India vs Australia cricket match so I can see the current match status and sports data."}],"resultDescription":"Returns a RichHeaderResponse containing an array of RichResult objects. Each result can include: stock data (asset info, current quote, time range, price timeseries, exchange info), news data (top stories, articles, topics), cricket/sports data, and other structured rich content types, depending on what the callback_key resolves to.","failureModes":["Invalid or missing callback_key returns an error response","callback_key that does not correspond to any rich data returns empty results array","Rate limiting or quota exhaustion returns an HTTP 429","Upstream Brave Search unavailability causes 503 or timeout","Stale cached data returned if Cache-Control header is not set to no-cache"],"whenToPreferThis":"Choose this endpoint when you need structured, enriched search header data — especially stock quotes with timeseries, top news articles, or sports scores — rather than plain web search results. Prefer it over generic search endpoints when the user is querying for financial data, market prices, or news aggregation that benefits from Brave's rich header format.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:51.381Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-brave-rich-search-header-ab39dc6c"}