Rate limits & quotas

Each plan has a request quota, a per-second rate limit and a maximum page size.

Plans

Plan	Quota	Requests / second	Max page size	Credits
free	100 in total	1	10	—
pro	50,000 / month	10	100	Packs of 25,000 requests
business	500,000 / month	50	100	Packs of 25,000 requests

Prices and upgrades: /pricing. Credits are prepaid requests spent only after the monthly quota runs out; they do not expire with the month.

What counts

Every authenticated request that reaches an endpoint counts as one, including 404s.
Not counted: 401, 400 for invalid parameters, 429 and any 5xx (refunded).
GET /me/usage counts too — read the response headers of your regular calls when you can.
Paid quotas reset at 00:00 UTC on the 1st of each month. The Free quota never resets.

Response headers

Successful responses tell you where you stand (IETF RateLimit header fields):

Headers

HTTP/1.1 200 OK
RateLimit-Limit: 50000
RateLimit-Remaining: 49231
RateLimit-Reset: 1036800
X-Quota-Remaining: 49231
X-Request-Id: 5f0c8d3e-4b7a-4f43-9a51-2a8c4f3f9b10

Header	Meaning
`RateLimit-Limit`	Requests in the current period (your plan quota).
`RateLimit-Remaining`	Requests left before 402 (credits not included).
`RateLimit-Reset`	Seconds until the quota resets; 0 for the lifetime Free quota.
`X-Quota-Remaining`	Same as RateLimit-Remaining.
`Retry-After`	On 429 and 503: seconds to wait before retrying.

When you hit a limit

Too many requests per second → 429 rate_limited: wait Retry-After seconds. Quota (and credits) exhausted → 402 payment_required: upgrade or buy credits; retrying will not help until the reset.