API 错误
Web Scraping API 返回标准 HTTP 状态码。非 2xx 响应包含一个 JSON 正文,其中带有描述出错原因的 error 字段。
| 代码 | 含义 |
|---|---|
400 | Bad Request。请求格式有误或参数无效。目标 URL 无法被抓取时也会返回此代码。 |
401 | Unauthorized。API 密钥缺失、无效,或已超出信用额度。 |
403 | Forbidden。你的套餐不包含此功能(例如 JavaScript 渲染或特定国家的地理定位)。请升级订阅以使用该功能。 |
406 | Not Acceptable。所请求的响应格式不受支持。 |
422 | Unprocessable Entity。请求本身有效,但无法完成。常见原因包括:目标网站在返回 200 OK 的同时返回了 CAPTCHA、响应 HTML 为空、Instagram 个人资料页返回了登录页面,或 wait_for_css 选择器始终未出现。 |
429 | Too Many Requests。你发送请求的速度过快或并行运行的请求过多。当 Google 检测到抓取行为时也可能返回此代码。 |
500 | Internal Server Error。我们这边出现了问题。请稍后重试。 |
503 | Service Unavailable。API 因维护而暂时下线。请稍后再试。 |
- 对
500和503采用指数退避重试(例如 1 秒、2 秒、4 秒)。 - 对
429在暂停后重试,并降低请求并发量。 - 在不修改请求的情况下,不要重试
400、401、403或406。
- Web Scraping API - 端点中心
- 基本请求 - 最简调用示例