# Brave Rich Search Header

> Brave Rich Search Header is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.005/call, status unknown (last checked 2026-10-18).

Retrieves rich search header results from Brave Search, including structured data for stocks, news, sports, and other enriched content types.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/brave/web/rich?utm_source=zero.xyz
- Price: $0.005/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Provider: AIsa MPP Data APIs
- Website: https://aisa.one
- Tags: web-search, financial-data, prediction-markets, weather, travel, data, search
- Canonical page: https://www.zero.xyz/c/aisa-mpp-data-apis-brave-rich-search-header-ab39dc6c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JpqJ86WF6GRPKTe68pxP4

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability aisa-mpp-data-apis-brave-rich-search-header-ab39dc6c
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

<!-- aisa-pricing:start -->
Published reference price: $0.005 USD per successful request. Account-specific pricing and final settlement may differ.
<!-- aisa-pricing:end -->

## Output

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.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "callback_key"
 ],
 "properties": {
  "callback_key": {
   "type": "string",
   "title": "Callback Key",
   "description": "The callback key to use for the rich header"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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_Exc
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-brave-rich-search-header-ab39dc6c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.aisa.one](https://www.zero.xyz/host/api.aisa.one/llms.txt)