Screenshot API error · HTTP 429

Rate limit exceeded

rate_limit_exceeded

Too many requests in a short time: the free plan allows a number of requests per minute, and this one went over it.

How to recognize it

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

HTTP/1.1 429
Content-Type: application/json

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "API rate limit exceeded"
  },
  "message": "API rate limit exceeded"
}

How to fix it

Wait for the time in the Retry-After header, then send the request again.
Spread requests out, or queue them, instead of sending bursts.
Paid plans have no per-minute limit.

Retry

After the seconds in Retry-After, at the start of the next minute.

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 quota_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.