入門
速率限制
每個帳戶共用一份額度，按月、日及小時計量。
各方案限制
| 方案 | 每月 | 每日 | 每小時 | 每次批量呼叫 |
|---|---|---|---|---|
| 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."
}
}