跳转到内容
serp.cheap

速率限制

每个 API 密钥都有一个由你的套餐决定的持续 每秒请求数 限制（Free 1 req/s → Max 60 req/s —— 参见 定价）。限制通过令牌桶强制执行：允许突发至 你的每分钟容量，然后请求会被平滑到持续速率。

当你被限制时

Section titled “当你被限制时”
{ "error": "rate_limited", "retry_after_ms": 850 }
  • HTTP 429，error: "rate_limited"。
  • retry_after_ms 告诉你重试前需要等待的最短时间。
  • 每个响应上的 x-ratelimit-remaining 头部报告本分钟内剩余的请求数。

并发

Section titled “并发”

除了每秒速率之外，还有一个对进行中请求的上限。如果你一次性发出大量请求， 你可能会看到：

  • 409 request_in_progress —— 一个完全相同的幂等请求已在运行。
  • 503 too_many_concurrent_requests —— 进行中的并发请求过多；请退避后重试。

处理限制

Section titled “处理限制”
  • 遵守 retry_after_ms；否则使用带抖动的指数退避。
  • 在客户端保持一个与你套餐速率相匹配的并发上限。
  • 官方 SDK 会自动重试 429/503。