跳到导航

一次读几个 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问题索引。