Skip to content

A thumbnail.ws alternative

The thumbnail.ws services moved to HQAPI. You get the same free limits, and a screenshot engine with more options. Switching is a change of address and a few parameter names.

Get your free token Read the reference

Try it

curl -o thumbnail.png -X POST --data '{"url": "https://example.com/", "image_width": 200}' \
    "https://api.eu-west.hqapi.com/api/v1/YOUR_TOKEN/screenshot/create"

The equivalent of a thumbnail.ws thumbnail/get call.

What stays the same

  • The free plan: 1,000 requests per month and 1 concurrent call.
  • The token in the URL path, and a GET interface for simple requests.
  • The same delay range, 0 to 5000 ms, and the full page and mobile options.

What is different

  • The address is https://api.eu-west.hqapi.com/api/v1/{token}/screenshot/create.
  • The default output is PNG; JPEG and PDF are supported with format.
  • The viewport (browser_width, browser_height) and the final image size (image_width, image_height) are separate parameters.
  • A screenshot is always captured fresh: there is no refresh option.
  • Cookie popups can be hidden with hide_cookie_popups.

Frequently asked questions

Do I need a new account?

Yes, sign up at HQAPI. It is free and gives you a token straight away.

Where are the parameter names compared?

In the migration guide, with a curl example for both services.

What does it cost?

The free plan is 1,000 requests per month and 1 concurrent call. Paid plans are on the pricing page.