> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.beatapi.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.beatapi.io/_mcp/server.

# 一次读几个 URL，其中一个失败，会全部失败吗？

> POST /v1/web/read 独立处理批次内的 1–10 个 URL，成功页写入 results，失败页写入 failed 并标注 blocked 或 unreachable，且只对成功读取的 URL 计费。

不会。单条 URL 读取失败不会拖垮整批 `POST /v1/web/read` 请求。每次可提交 `1–10` 个公开 HTTP(S) 链接，接口会将成功页面归入 `results`，将无法读取的页面归入 `failed`。

## 按 URL 对照 `results` 与 `failed`

即便整批链接全部无法读取，`POST /v1/web/read` 仍返回 HTTP `200`，其中 `results` 为空数组，`failed` 逐条列出失败原因：

* **`blocked`**：目标网站返回了访问拦截页或防爬挑战页。
* **`unreachable`**：目标页面无法拉取。

提交后按输入链接逐一核对 `results` 与 `failed`，并留存 `request_id` 便于追溯批次。例如迁移指南已成功进入 `results`，而发布日期公告出现在 `failed`（`blocked`）时，先输出有原文依据的迁移步骤，把发布日期标为待核，再为其他公开公告地址单独发起新的 Read 请求。

## 部分失败批次的计费规则

`POST /v1/web/read` 按 `results` 中成功读取的 URL 计费（每条 `$0.002`）。`failed` 中的 URL 不扣费，整批未读到任何页面时费用为零。

## 合同与相关问题

执行前免费检查对应合同：`data:web.search`, `data:web.read`, `data:web.map`。

[返回Web Search问题索引](/zh/faq/web)。