Features
The thumbnails.cloud API generates JPG and PDF 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.
Examples
The API supports a ton of formats, but here are some examples:
| example.doc | example.docx | example.ai | example.eps |
|---|---|---|---|
Usage
URL structure:
https://thumbnails.cloud/v1/jpg
?token=your-api-token
&url=https://example.com/my-file.doc
&size=600
&mode=cropSimply change jpg to pdf to get a PDF preview instead.
| Parameter | Required | Description |
|---|---|---|
url | The URL of the original document. Should be publicly available via HTTP or HTTPS. Make sure to urlencode your URL! | |
token | Your API token. Sign up above. | |
size | Pixel width of your thumbnail. Defaults to 600. | |
mode | Specify crop to get a square image, or orig to maintain original aspect ratio. Defaults to crop. |
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.
