# AIsa Smart Web Search

> AIsa Smart Web Search is a paid API for AI agents from AIsa MPP Data APIs at api.aisa.one, paid per call via MPP, $0.001/call, status unknown (last checked 2026-10-14).

Performs a smart web search returning ranked, enriched results with snippets, metadata, and optional full-page content for a given query.

## Facts

- Endpoint: GET https://api.aisa.one/apis/v1/search/smart?utm_source=zero.xyz
- Price: $0.001/call
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- 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-aisa-smart-web-search-1d67b438
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6Yj5XmYbLi52uT2157P8l

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-aisa-smart-web-search-1d67b438
```

Example prompt: Search the web for the latest news about Federal Reserve interest rate decisions from the past week, and return 20 results with key text fragments so I can review the most relevant ones.

## When to prefer this

Choose this endpoint when you need ranked, enriched web search results with optional full-page extraction, freshness filtering, and site-scoping — especially when combining web search with structured data needs like financial news, travel, or prediction markets. It is better than generic search APIs when you need mainText intelligent fragments, pagination support, and per-request micro-pricing via USDC.

## Known failure modes

- Empty result set if query is too niche or freshness filter is too narrow
- Truncated content if contentTimeout is too short for slow pages
- Fewer results than requested if the index lacks sufficient matches
- No content returned if enableContent is false (default)
- Caching may return stale results unless Pragma: no-cache header is set

## How this service works

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

## Output

Returns a JSON object containing a `webPages.value` array of ranked results, each with URL, page title, snippet, optional main text fragment, optional long-form content, relevance score, publication date, logo, site name, and image list. Also includes the original query in `queryContext`.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "q"
 ],
 "properties": {
  "q": {
   "type": "string",
   "minLength": 1,
   "description": "The user's search query term, which cannot be empty."
  },
  "count": {
   "enum": [
    10,
    20,
    30,
    40,
    50
   ],
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "description": "The number of search results to return. Defaults to 10, maximum 50. Enumerated values: 10 / 20 / 30 / 40 / 50 The actual number returned may be less than requested. Use this parameter with the offset parameter for pagination."
  },
  "sites": {
   "type": "string",
   "description": "The value must be in host address format (e.g., baijiahao.baidu.com). Returns results only from the specified site(s)."
  },
  "offset": {
   "type": "integer",
   "default": 0,
   "minimum": 0,
   "description": "The zero-based offset indicating how many results to skip before returning. Defaults to 0. Use with the count parameter for pagination. There is no upper limit for offset; setting a large value may result in no results being returned."
  },
  "mainText": {
   "type": "boolean",
   "default": false,
   "description": "Controls whether to return key fragments of dynamic abstracts:true： Return key fragmentsfalse：Do not return key fragmentsDefault false"
  },
  "freshness": {
   "enum": [
    "Day",
    "Week",
    "Month"
   ],
   "type": "string",
   "description": "Filter search results by time range: - Day (past 24 hours) -Week (past 7 days) - Month (past 30 days)"
  },
  "contentType": {
   "enum": [
    "HTML",
    "MARKDOWN",
    "TEXT"
   ],
   "type": "string",
   "default": "TEXT",
   "description": "The format of the long abstract (content) to return. Options:：- HTML- MARKDOWN- TEXT(default)"
  },
  "blockWebsites": {
   "type": "string",
   "description": "The value must be in host address format (e.g., baijiahao.baidu.com). Excludes results from the specified site(s)."
  },
  "enableContent": {
   "type": "boolean",
   "default": false,
   "description": "ontrols whether to return long abstract content: -true: Return long abstracts -false: Do not return long abstracts Defaults to false"
  },
  "contentTimeout": {
   "type": "number",
   "default": 0,
   "maximum": 10,
   "description": "Timeout for reading long abstracts. If reading exceeds this time, it will terminate and no long abstract will be returned for that result. Defaults to 0 (seconds), maximum 10s."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "webPages": {
   "type": "object",
   "properties": {
    "value": {
     "type": "array",
     "items": {
      "type": "object",
      "properties": {
       "url": {
        "type": "string",
        "description": "Webpage URL"
       },
       "logo": {
        "type": "string",
        "description": "Website logo (included in some webpages)"
       },
       "name": {
        "type": "string",
        "description": "Webpage title"
       },
       "score": {
        "type": "number",
        "description": "Content relevance score"
       },
       "content": {
        "type": "string",
        "description": "Long abstract information of the webpage, retrieved from the main text. MARKDOWN and HTML formats include image links with anchor positions"
       },
       "snippet": {
        "type": "string",
        "description": "Text snippet describing the webpage content"
       },
       "mainText": {
        "type": "string",
        "description": "Dynamic abstract fragment extracted from the text, most relevant to the query. More intelligent than snippet"
       },
       "siteName": {
        "type": "string",
        "description": "Website name (included in some webpages)"
       },
       "imageList": {
        "type": "array",
        "description": "List of image URLs in the webpage (included in some webpages, depending on whether the page contains images)"
       },
       "datePublished": {
        "type": "string",
        "description": "Page publication time (included in some sites) Example: 2025-07-14T01:15:00.0000000Z"
       },
       "contentCrawled": {
        "type": "boolean",
        "description": "Long abstract retrieval status: true for success (content is included in content), false for failure (content is empty)"
       }
      }
     },
     "description": "Detailed result data returned"
    }
   }
  },
  "queryContext": {
   "type": "object",
   "properties": {
    "originalQuery": {
     "type": "string",
     "description": "The user's original search query"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aisa-mpp-data-apis-aisa-smart-web-search-1d67b438/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)
