Skip to main content
每个 AdsCrawl 套餐都包含积分额度和一组限制，用于控制你可以发起的请求数量、可同时运行的浏览器会话数量，以及可以保存的云浏览器配置数量。了解这些边界有助于你设计可靠的自动化流程，使其能够优雅地处理错误，避免在生产环境中遇到意外阻碍。

​
积分消耗

积分是 AdsCrawl 上所有操作的计费单位。下表说明了每种 API 类型的积分消耗方式。
积分一旦消耗即不可退还。如果浏览器任务请求在执行过程中失败（积分已经扣除后），积分不会退回。请在发送请求前验证输入，避免不必要的积分损失。
云浏览器按启动分钟计费，向上取整。运行 90 秒的浏览器将消耗 2 积分。重复停止通知不会触发重复扣费：计费在第一次确认停止后即结束。

​
速率限制

AdsCrawl 对每个 API 密钥执行速率限制，以保护服务稳定性。超出速率限制时，API 返回 HTTP 429。请延迟后重试。
收到 429 响应时，请实现指数退避策略。初始延迟 1 秒，每次重试加倍，直至合理上限（例如 30 秒），然后放弃。

​
CDP 会话速率限制

远程 CDP 会话对每个 API 密钥有并发限制。超出后将返回：
HTTP 状态为 429，错误代码为 SESSIONS_PER_API_KEY_LIMIT_REACHED。在创建新会话前删除已有会话，或如果你的套餐允许，将负载分配到多个 API 密钥上。

​
并发限制

​
云浏览器并发

每个用户账户都有一个 runningLimit，即同一时间内可处于活跃状态（starting、running 或 stopping 状态）的云浏览器会话数量上限。默认值为 1。 你可以随时通过 GET /cloud-browsers 查看当前使用情况：
  • limit —— 你的套餐允许保存的云浏览器配置数量
  • runningLimit —— 你的账户可同时运行的会话数量上限
  • runningCount —— 当前处于 starting、running 或 stopping 状态的会话数量，跨所有配置、页面和 API 密钥统计
runningCount 统计范围覆盖所有你的 API 密钥以及控制面板操作。处于 stopping 状态的会话仍会占用运行槽位，直到状态变为 stopped。
当你尝试启动云浏览器但运行额度已满时，API 返回 409 CLOUD_BROWSER_CONCURRENCY_LIMIT：
降低 runningLimit 不会停止现有会话。 它仅阻止新的启动操作，直到运行中的会话释放容量。当达到上限时，请先停止运行中的浏览器，再尝试启动新的会话。

​
错误代码参考

以下错误代码表示计费或容量问题。请在你的应用中使用 HTTP 状态码和稳定的 code 字段进行错误处理，不要依赖可能变更的可读 error 消息。

​
请求大小和参数限制

以下硬限制适用于所有 API 请求。超出这些限制的请求将在消耗积分前被拒绝，返回 HTTP 400。