Screenshot API error · HTTP 429

Monthly quota used up

quota_exceeded

All requests of your plan for this month are used. The body’s quota object shows the limit, what is used and when it resets (quota.resets_at).

How to recognize it

The API answers with status 429 and a JSON body with the message and the error.code quota_exceeded, for example:

HTTP/1.1 429
Content-Type: application/json

{
  "error": {
    "code": "quota_exceeded",
    "message": "You used all your monthly requests. Please upgrade your plan at https://app.screenshotbase.com/subscription"
  },
  "message": "You used all your monthly requests. Please upgrade your plan at https://app.screenshotbase.com/subscription"
}

How to fix it

Upgrade your plan in the dashboard, or wait for the reset.
Check quota.required: a PDF, markdown or a render of HTML input is checked against the quota before it is rendered, so it can be refused while a few requests are left.
Only successful requests count: requests the API answers with an error are not billed. The exception is a 504 from our gateway, which stops waiting while the render may still finish and be billed; see the status codes.

Retry

After the quota resets at quota.resets_at, or right after an upgrade.

Billing

Not billed: a request answered with this error does not count against your quota.

Every response carries an X-Request-Id header. If this page does not explain the error, write to support@screenshotbase.com with that id. All statuses: status codes.

Other API errors

forbidden403 grace_quota_exceeded429 invalid_api_key401 invalid_parameters422 key_not_allowed_for_product403 missing_api_key401 not_found404 output_too_large_for_format422 overage_quota_exceeded429 page_too_large422 rate_limit_exceeded429 referrer_not_allowed403 render_failed500 storage_unavailable503 target_blocked_private_range422 target_timeout408 target_unreachable502 target_unresolvable400

Screenshot API

Take screenshots from your code

screenshotbase renders any website in a real browser and returns the image: full page or viewport, any device size, retina, from 100+ countries, with cookie banners and ads hidden.

/v1/take documentation Screenshot API All documentation

300 free screenshots every month. No credit card required.

GET https://api.screenshotbase.com/v1/take?url=https://example.com&full_page=true

# Response: the image (PNG, JPG, WebP or GIF)
curl -G "https://api.screenshotbase.com/v1/take" \
  --data-urlencode "url=https://example.com" \
  -d viewport_width=1280 -d viewport_height=800 \
  -d format=png \
  -H "apikey: YOUR-API-KEY" \
  -o screenshot.png

More free tools

Website screenshot Capture any page as an image. Full page screenshot Capture a whole page, top to bottom. Mobile website screenshot See a site on iPhone, Android and iPad. URL to PDF Save any web page as a PDF. URL to markdown Turn a web page into markdown. HTML to PDF Print your own HTML as a PDF. HTML to image Render HTML and CSS as a PNG, JPG or WebP. HTML to markdown Turn HTML into clean markdown. URL to PNG Save a web page as a PNG image. URL to JPG Save a web page as a JPG image. Scrolling screenshot One long image of a page, no stitching. HTML to PNG Render HTML as a lossless PNG. HTML to JPG Render HTML as a compact JPG. Viewport sizesScreen sizes and pixel ratios of 46 devices. ErrorsChrome network errors and screenshot API errors, with fixes.