Generate file thumbnails on the fly

The simplest API you've ever used for generating previews of 50+ file types.

Get your API key


The API generates JPEG file previews for all common document formats, using a simple API. Get an API token for $8/mo for personal and small-scale projects, and create an unlimited number of preview images! For large-scale and enterprise licensing, please contact us.


The API supports a ton of formats, but here are some examples:

.doc example.docx example.eps example


URL structure:
urlThe URL of the original document. Should be publicly available via HTTP or HTTPS. Make sure to urlencode your URL!
tokenYour API token. Sign up above.
sizePixel width of your thumbnail. Defaults to 600.
modeSpecify crop to get a square image, or orig to maintain original aspect ratio. Defaults to crop.
gravityFor documents, specify where the gravity lies for cropping. Options: North, South, East, West.
formatBy default, an image is returned. Specify json to get back a base64 encoded version in a JSON object.
offsetFor videos, specify a second offset to use for the thumbnail. Defaults to 0. If you specify a offset higher than the duration of the video, the conversion will fail.

Supported file extensions

You can query the /v1/extensions endpoint to get an up-to-date overview of the supported file extensions. Note that this refers to the file types that can be converted into JPG, PDF support is currently slightly more limited.

How we handle your data

We care about privacy, and know that you might be using our API to create previews for potentially confidential documents. That's why we don't log the URLs of the documents you convert, nor do we keep the original documents after we've converted them.

We do however temporarily store the create preview image using on our CDN servers, to allow hot linking to dynamic previews, without having to recreate the preview image on every request. There is, however, no way for other users of the service to access a list of the files you converted through the API.

Thumbnails Cloud - The simplest API for generating file thumbnails | Product Hunt Embed