Skip to main content
POST
Reference example
取回你已经拿到的 URL 的干净正文 —— 来自搜索结果、站点地图或用户输入。urls 必填,可一次传多个。返回 results[],含 url、title、raw_content 和 images,另有一个 failed_results[] 数组 —— 这个一定要读,取不到的页面会被记在那里,而不是抛错。可选 format(markdown 或 text)与 extract_depth。实测取 1 个页面约 1 秒。只要页面能点得出名字,就用它而不是 post_tavily_search —— 为已知页面去搜索既贵又未必搜得到。如果是一长串 URL 且不急,post_firecrawl_batch_scrape 会作为后台任务跑完。想先摸清整站有哪些 URL,用 post_tavily_map。
第一次用? 把任意 MCP 客户端指向 https://mcp.aisa.one/mcp —— Claude Code、 Codex、Cursor、VS Code 都可以。鉴权走 OAuth:客户端打开浏览器,你点一次 Allow,不需要粘贴任何 key。之后智能体通过几个元工具调用所有端点: search、list_categories、get_details 和 batch_quote 免费,batch_use 按次计费。各客户端的接入步骤见通过 MCP 连接;实时工具列表和 每次调用的价格见 aisa.one/zh-cn/mcp。
在你的 agent 里把这个端点跑起来 →

请求规范

  • 方法与路径: POST /apis/v1/tavily/extract
  • 可用状态: enabled
  • 请求 URL 模板: https://api.aisa.one/apis/v1/tavily/extract
  • Runtime 事实版本: ea2301436db90d0b30e55885326cd5057bea93ff7d26d9bced8e1ae7f1911ef4
完整 OpenAPI 定义 有效请求与价格声明(包括认证和引用的 schema):

费用与请求规则

按用量计费;默认请求预估费用:$0.024 USD(不是固定价格)。 声明的单位费率:每 tavily_credit $0.008 USD。 最终费用以账户适用价格及实际结算为准。 公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口,执行前请针对完整请求获取免费报价;执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。
  • 默认请求参考估价(USD): 0.024
  • 声明的单位费率(USD): 0.008
  • 计费单位: tavily_credit
  • 计费依据: response_units
  • 公开参考倍率: 1.0
  • 结算证据来源: response_body

授权

Authorization
string
header
必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

请求体

application/json
urls
必填

要从中提取内容的 URL。支持单个 URL 字符串和 URL 字符串数组。

示例:
chunks_per_source
integer
默认值:3

每个来源返回的相关内容块的最大数量。仅在提供 query 时可用。

必填范围: 1 <= x <= 5
extract_depth
enum<string>
默认值:basic

提取过程的深度。

可用选项:
basic,
advanced
format
enum<string>
默认值:markdown

提取的网页内容格式。

可用选项:
markdown,
text
include_favicon
boolean
默认值:false

为每个结果包含 favicon URL。

include_images
boolean
默认值:false

包含从 URL 中提取的图片列表。

include_usage
boolean
默认值:false

在响应中包含信用额度用量信息。

query
string

用于对提取的内容块进行重新排序的用户意图。

timeout
number<float>

等待 URL 提取的最长时间(秒)。如果省略,默认超时时间取决于 extract_depth:basic 为 10 秒,advanced 为 30 秒。

必填范围: 1 <= x <= 60

响应

已成功返回提取结果。

failed_results
string[]

无法处理的 URL 列表。

request_id
string

唯一请求标识符。

response_time
number<float>

完成请求所用的时间(秒)。

results
object[]
usage
object