Website thumbnail API
Show a preview of any website in your product: capture the page and receive it already resized, in the format you need.
Try it
curl -o thumbnail.jpg -X POST --data '{"url": "https://example.com/", "image_width": 320, "format": "jpeg", "jpeg_quality": 80}' \
"https://api.eu-west.hqapi.com/api/v1/YOUR_TOKEN/screenshot/create"The page is rendered at the browser size you choose and then resized to image_width.
Made for previews
- image_width from 32 to 1920 pixels (and image_height up to 8000); give one and the other follows the page proportions.
- PNG for sharp interfaces, JPEG with a quality from 1 to 100 for small files.
- Render at a desktop or a mobile viewport, then resize.
- Light or dark theme, so the thumbnail matches your site.
Good to know
- Every request captures a fresh screenshot: store the result in your own cache or storage.
- The delay (0 to 5000 ms) lets late-loading content appear before the capture.
Frequently asked questions
How do I get a thumbnail instead of a full-size screenshot?
Add image_width (and optionally image_height). The result is resized before it is sent.
Which formats can I get?
PNG, JPEG and PDF.
Is there a free plan?
Yes: 1,000 requests per month and 1 concurrent call.