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.

PlanDaily creditsRate limitAPI keys
Free50060 req/min1
Pro20,00060 req/min5
Business200,000200 req/minUnlimited

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.