Reference
Credits and limits
You pay in credits, one screenshot at a time. A failed screenshot is not charged.
What a screenshot costs
| What you ask for | Credits |
|---|---|
| A screenshot | 1 |
| A screenshot from a chosen country | 2 |
The other options are included: device, full page, format, cleaning up the page.
A click before the screenshot (click_selector or click_text) adds 1 credit. A click that is refused or stopped is not charged.
- The credits are reserved when the screenshot starts and charged when it succeeds.
- A page that answers an error of its own, such as 404 or 451, is still a screenshot: it is captured and charged.
- Asking again with the same
Idempotency-Keyreturns the same screenshot and is not charged twice. See Retries and Idempotency-Key.
Where credits come from
- Free credits, every month. An account without a monthly plan gets 50 credits each calendar month (UTC). They are given the first time you use the account that month, starting with the day you sign up, with no card. They do not carry over: what is left is gone on the 1st of the next month. After your first month, your email address must be confirmed to keep getting them.
- A monthly plan. A number of credits each month. What is left at the end of the paid month does not carry over.
- Packs. Bought once. They do not expire.
The credits that expire first are used first. So the free credits of the month are used before a pack: a pack is not touched while free credits are left.
Credits given once at signup before 12 October 2026, under the earlier rule, stay on the account and do not expire.
See what is left
/v1/creditsfree_monthly describes the free credits of this account: how many it gets each month, how many of this month's are left, and when the next ones can arrive. eligible is false, with a reason, for an account on a monthly plan (plan), with an email address still to confirm (unverified), or with screenshots blocked (blocked); renews_at is then null. withheld means the first month of an account whose address closed another account recently: the next month is normal. delayed means the account is eligible but this month's credits could not be given today: they are at its first use tomorrow. pending means they are given at the next use of the account.
With the image, two headers say the same thing: X-Credits-Charged and X-Credits-Remaining. When you run out, a request fails with insufficient_credits and status 402.
Limits
Limits apply to the account. Several API keys share them.
| Limit | On free credits | After a first payment |
|---|---|---|
| Requests per minute | 10 | 120 |
| Screenshots running at once | 2 | 20 |
| Failed screenshots per day | 15 | 300 |
- Over the number of requests per minute:
rate_limited, with aRetry-Afterheader. - Too many screenshots running at once:
concurrency_limit. - Too many failed screenshots in a day:
failure_budget_exceeded.
Limits that protect websites
A single website does not get more than 4 screenshots at once, nor more than 30 a minute, from all our users together. Past that, a request fails with domain_busy: try again a minute later.
Limits of one screenshot
| Limit | Value |
|---|---|
| Time for a page to load | 35 seconds |
| Weight of a page | 10 MB |
How long a request waits before answering 202 |
50 seconds |
| How long an image is kept | 7 days |
| How long a link to an image works | 15 minutes |