SerpBase

API Key 与速率限制

每个请求都用 API Key 认证,并计入你账户的每秒请求数。

如何传 Key

每个请求都在 X-API-Key 请求头里带上 Key。放在网址里的 Key 会被拒绝,以免出现在代理或浏览器日志里。在控制台的 API Keys 页面创建、重命名和撤销 Key。

BASH
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: YOUR_API_KEY"

速率限制

超过限制的请求会立即以 status 1029 被拒绝,并带 Retry-After 响应头,不扣费。每个响应里的 X-RateLimit-Limit 和 X-RateLimit-Remaining 可以帮客户端控制发送节奏。

账号 QPS 自动升档

符合条件的充值确认入账后,按累计 USD 金额自动提升至至少以下 QPS:$3 → 2、$50 → 5、$100 → 10、$200 → 15、$1,000 → 50、$10,000 → 500。未满 $3 保持当前账户限额。只升不降,已有更高限额不会降低;不是无限 QPS。

累计符合条件的充值(USD)至少提升至(QPS,请求/秒)
≥ $32 QPS
≥ $505 QPS
≥ $10010 QPS
≥ $20015 QPS
≥ $1,00050 QPS
≥ $10,000500 QPS

仅统计已确认入账的 USD 积分包(credit_pack)和自动充值(auto_topup)付款。订阅(包括 Starter Boost)、赠送和礼品码不计入。积分余额不等于累计充值美元金额;非 USD 付款不能未经换汇直接计作 USD。

同一账户的所有 API Key、产品和网关共用一个 QPS 限额;增加 Key 不会增加限额。

符合条件的充值确认入账后自动提升账号 QPS,付款跳转回来不代表已生效。现有限额以账户显示的服务端数值为准,API Key 同步可能短暂延迟。

账户余额

查询有效 API key 所属账户的当前额度。该请求不消耗搜索额度。

GET
0 点
/account/credits

请在 X-API-Key 请求头中传入密钥。接口不接受 URL 查询参数中的 API key。

BASH
curl https://api.serpbase.dev/account/credits \
  -H "X-API-Key: your_api_key"
JSON
{
  "status": 0,
  "credits": 12345,
  "permanent_credits": 10000,
  "expiring_credits": 2345,
  "expiring_expires_at": 1798761600
}

该接口每个账户每分钟最多调用 60 次。expiring_expires_at 为 Unix 秒级时间戳;没有有效限时额度时为 0。