读取网页

请求
返回
计费
错误
说明

输入一个网址，返回这个网页的正文：去掉导航、广告、页脚，留下标题和正文，格式可以选 Markdown 或纯文本。适合给大模型读网页。

请求

POST https://platform.kuaisou.com/api/read-webpage
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

请求参数

参数	类型	必填	说明
url	string	是	网页地址，最多 1024 个字符
format	string	否	`markdown`（默认）或 `json`；填别的按 `markdown`

请求示例

curl -X POST https://platform.kuaisou.com/api/read-webpage \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://www.example.com/article","format":"markdown"}'

{
  "code": 200,
  "msg": "",
  "data": {
    "url": "https://www.example.com/article",
    "title": "网页标题",
    "canonical": "https://www.example.com/article",
    "lang": "zh",
    "status": 200,
    "format": "markdown",
    "quality": 0.92,
    "textChars": 3580,
    "warnings": [],
    "pageType": "article",
    "author": "作者",
    "siteName": "网站名",
    "date": "2025-06-01",
    "body": "# 网页标题\n\n正文……"
  },
  "logId": "req_..."
}

返回字段

字段	说明
url	最终读取的地址（有跳转时是跳转之后的）
title	网页标题
canonical	网页声明的规范地址
lang	网页的语言
status	读取网页时对方返回的 HTTP 状态码
format	你要的格式
quality	正文抽取的质量分
textChars	正文的字数
warnings	抽取时的提示（比如正文可能不完整）
pageType	网页类型（文章、列表页等）
author、siteName、date	作者、网站名、发布时间，网页里有才有
body	正文：`format` 是 `markdown` 时是 Markdown，是 `json` 时是纯文本
content	只在 `format` 是 `json` 时有：抽取结果的完整结构

计费

只有真的抽到正文才扣费。 网页打不开、站点不允许抓取、没有抽到正文，都回 422、不扣钱。单价见开放平台首页的价格表。

错误

code	什么时候
400	请求体不是合法 JSON、`url` 是空的、`url` 超过 1024 个字符
401	API Key 无效或已停用
402	余额不足
422	没读成功：`msg` 说停在哪一步、为什么，`data` 里有 `step`（哪一步）、`status`（对方的状态码）、`url`
500	读取单价、查询余额或计费失败（不扣费）
502	读取服务暂时不可用（不扣费）

见错误码。

说明

我们会遵守网站的 robots.txt：站点不允许抓取的网页读不了。
有些网站暂时读不了，会回 422 并说明原因。