Rate Limit & Quotas
You can use a certain number of requests per month, defined by your plan.
Once you go over this quota, the API returns a 429 HTTP status code, and you either need to upgrade your plan or wait until the end of the month. We also enforce a minute rate limit on the free plan: up to 10 requests per minute. If you exceed this, the API returns a 429 HTTP status code. You then have to wait until the end of the minute to make more requests. Not every request counts towards your monthly request volume.
Not every request counts
Only successful calls count against your quota. Any error on our side or validation errors (e.g., wrong parameter) will NOT count against your quota or rate limit.
Cost per request
A screenshot, a PDF, a markdown conversion and a render of HTML input each count as one request. The X-Cost header of a successful response tells you how many requests the call counted. A PDF, markdown or a render of HTML input counts the same with and without upload=1, and your quota is checked before it is rendered: if the quota does not cover it, the API answers 429 with quota.required instead of rendering it. A PDF, markdown or a render of HTML input requested with a sandbox API key costs nothing (X-Cost: 0).
Response Headers
We attach specific headers to tell you your current quota and how much you have remaining in the period. The monthly headers are sent on every plan; the per-minute headers are only sent on the free plan.
X-RateLimit-Limit-Quota-Minute: 10
X-RateLimit-Limit-Quota-Month: 300
X-RateLimit-Remaining-Quota-Minute: 5
X-RateLimit-Remaining-Quota-Month: 199
Paid plans use a dedicated rate limiter that does not expose the per-minute
X-RateLimit-*-Minute headers — you still receive the monthly
X-RateLimit-*-Month headers. You can also monitor your quota
programmatically with the status endpoint — requests to it are
free.