> ## Documentation Index
> Fetch the complete documentation index at: https://aisa.one/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Exa Contents

> 为你已经拿到的 URL 取回页面正文和元信息。

为你已经拿到的 URL 取回页面正文和元信息。`ids` 必填，接收 [`post_exa_search`](/docs/zh/api-reference/search/post_exa-search) 返回的 `id` —— 那本身就是 URL，所以任何 URL 都能用。可开关 `text`、`highlights`、`summary`、`subpages`、`livecrawl`。返回 `results[]`（含 `id`、`title`、`url`、`author`、`text`），外加一个 **`statuses[]` 数组，逐个 URL 给出 `status` 和 `source`** —— 一定要读，取不到的 URL 记在那里而不是抛错。命中缓存时立即返回，未命中则回落到实时抓取。实测 1.2 秒。按次固定计费。要的是整站而不是一份 URL 清单，用 [`post_firecrawl_crawl`](/docs/zh/api-reference/search/post_firecrawl-crawl)。

<Note>
  **第一次用？** 把任意 MCP 客户端指向 `https://mcp.aisa.one/mcp` —— Claude Code、
  Codex、Cursor、VS Code 都可以。鉴权走 OAuth：客户端打开浏览器，你点一次
  Allow，不需要粘贴任何 key。各客户端的具体命令和每次调用的价格见
  [aisa.one/zh-cn/mcp](https://aisa.one/zh-cn/mcp#connect)。
</Note>

[在你的 agent 里把这个端点跑起来 →](https://aisa.one/mcp?from=/zh/api-reference/search/post_exa-contents)


## OpenAPI

````yaml openapi/zh/exa.json POST /exa/contents
openapi: 3.0.0
info:
  title: Exa API
  version: 1.0.0
  description: >-
    通过 AIsa 网关开放的 Exa 神经语义搜索 endpoint 的统一 API 文档：Search、Contents、Answer，以及异步的研究型
    Agent Runs。


    Search、Contents 和 Answer 为同步接口，每次成功请求按固定费率计费。Agent Runs
    为异步接口：调用方提交任务，然后轮询返回的任务资源以获取状态和结果，每次任务按固定费率计费。上游 4xx 响应（例如
    401/403/404）不计费。Exa 返回的 `costDollars` 字段是上游成本明细，仅供参考——客户计费以上述 AIsa 固定价格为准。
servers:
  - url: https://api.aisa.one/apis/v1
security:
  - bearerAuth: []
paths:
  /exa/contents:
    post:
      tags:
        - https://docs.exa.ai/reference/get-contents
      summary: 为一组 URL 提取完整页面内容。
      description: >-
        为你已经拿到的 URL 取回页面正文和元信息。`ids` 必填，接收 `post_exa_search` 返回的 `id` —— 那本身就是
        URL，所以任何 URL 都能用。可开关
        `text`、`highlights`、`summary`、`subpages`、`livecrawl`。返回 `results[]`（含
        `id`、`title`、`url`、`author`、`text`），外加一个 **`statuses[]` 数组，逐个 URL 给出
        `status` 和 `source`** —— 一定要读，取不到的 URL
        记在那里而不是抛错。命中缓存时立即返回，未命中则回落到实时抓取。实测 1.2 秒。按次固定计费。要的是整站而不是一份 URL 清单，用
        `post_firecrawl_crawl`。
      operationId: post_exa_contents
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  type: array
                  items:
                    type: string
                  description: 要获取内容的 URL（或 Exa 结果 id）。
                  example:
                    - https://example.com/article
                text:
                  type: boolean
                  description: 返回完整的页面文本。
                highlights:
                  type: boolean
                  description: 返回高亮的相关片段。
                summary:
                  type: boolean
                  description: 返回该页面由 AI 生成的摘要。
                subpages:
                  type: integer
                  description: 同时抓取的关联子页面数量。
                livecrawl:
                  type: string
                  enum:
                    - always
                    - fallback
                    - never
                  description: 新鲜度策略：始终实时抓取、缓存未命中时退回实时抓取，或从不实时抓取。
              required:
                - ids
      responses:
        '200':
          description: 内容获取成功。
          content:
            application/json:
              schema:
                type: object
                properties:
                  requestId:
                    type: string
                  results:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        url:
                          type: string
                        publishedDate:
                          type: string
                        author:
                          type: string
                        id:
                          type: string
                        text:
                          type: string
                        highlights:
                          type: array
                          items:
                            type: string
                        summary:
                          type: string
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.