入门
速率限制
每个账户共用一份额度，按月、日和小时计量。
各套餐限制
| 套餐 | 每月 | 每天 | 每小时 | 每次批量调用 |
|---|---|---|---|---|
| Free | 30,000 | 1,000 | 100 | 100 |
| Starter | 150,000 | 无上限 | 1,500 | 500 |
| Pro | 500,000 | 无上限 | 5,000 | 1,000 |
| Business | 2,000,000 | 无上限 | 20,000 | 2,000 |
| Enterprise | 定制 | |||
一份额度覆盖所有产品，每次计量调用只计一次。
免密钥演示每个 IP 每天约可发送 100 次请求。
速率限制响应头
- X-RateLimit-Limit
月度额度。
- X-RateLimit-Remaining
本月剩余请求数。
- X-RateLimit-Reset
月度额度的重置时间，Unix 时间戳。
- X-RateLimit-Daily-*
每日上限对应的同样三项，仅限有每日上限的套餐。
- X-RateLimit-Hourly-*
每小时限制对应的同样三项。
- Retry-After
触发的限制重置前的秒数。
HTTP/2 200
x-ratelimit-meter: request
x-ratelimit-limit: 30000
x-ratelimit-remaining: 25820
x-ratelimit-reset: 1793491200
x-ratelimit-daily-limit: 1000
x-ratelimit-daily-remaining: 788
x-ratelimit-hourly-limit: 100
x-ratelimit-hourly-remaining: 86限制用尽时
reason
- hourly_limit
每小时限制已用尽；一小时内恢复。
- daily_quota
每日上限已用尽；UTC 午夜重置。
- monthly_quota
月度额度已用尽；在您的重置日期重置。
- insufficient_for_batch
批量调用所需超过剩余额度；needed 给出所需数量。
{
"error": "rate_limit_exceeded",
"reason": "daily_quota",
"message": "You have used today's 1,000 requests.",
"meter": "request",
"plan": "Free",
"limit": 1000,
"usage": 1000,
"remaining": 0,
"resetDate": "2026-11-01",
"resetAt": "2026-10-07T00:00:00Z",
"retryAfter": 35400,
"softBlock": false,
"upgrade": {
"recommendedPlan": "Starter",
"url": "https://ipscanner.io/pricing",
"message": "You have used 100% of today's request allowance. The Starter plan has no daily cap."
}
}