Rate limits and credits
How credits are charged (one per item returned), the daily allowance and per-minute limit on each plan, and what a 429 means.
Credits are charged by the number of items a response returns. A single-item lookup costs 1 credit; a list endpoint costs 1 credit per item in the response, so asking for fewer with per_page costs less. Credits reset daily at midnight UTC, and limits are per account rather than per API key — extra keys separate your apps without dividing the budget.
| Plan | Daily credits | Rate limit | API keys |
|---|---|---|---|
| Free | 500 | 60 req/min | 1 |
| Pro | 20,000 | 60 req/min | 5 |
| Business | 200,000 | 200 req/min | Unlimited |
Going over returns 429 rate_limited until the reset. Nothing is charged for it and nothing is cut off beyond that day; retry with exponential backoff. What each plan costs and reaches is on the pricing page.