Thumbnail API – Specification

Using the Thumbnail API is as easy eating a pile of banana pancake. Send your file to this URL and get a thumbnail image in return:

POST https://www.thumbnailapi.com/api/v1/thumbnail/

Custom thumbnail sizes

By default, this will return a PNG thumbnail image of 200px x 200px. However, you can specify width and height as well:

POST https://www.thumbnailapi.com/api/v1/thumbnail/{width}x{height}

Calling https://www.thumbnailapi.com/api/v1/thumbnail/400x300 for example, will return a PNG, which is 400px wide and 300px high.

Authentication

The Thumbnail API uses API keys to allow access to the API. You can obtain your API key at the dashboard. All clients must send this token in the Authorization header when making requests:

Authorization: Token <your-api-key>

Quota

The price of Thumbnail API depends on the processing time of your conversions. Each successful conversion decreases your monthly quota by the time it took to convert your file into the target format. However, a conversion can reduce your quota by a maximum of 20 seconds.

All authorized API responses will return your current monthly quota of avaliable processing time in seconds via HTTP header:

X-THUMBNAILAPI-QUOTA: 1500

Supported Filetypes

Thumbnail API supports all common file formats. If there is a file format missing, that you'd like to convert from, please let us know

Images

Raster graphic image formats: png, jpeg, bmp, tiff, gif
Vectorial graphic format: svg
Camera raw format: dng, arw

Office/Text Document

simple text file: txt, json
office document: odt, doc, docx
pdf document

Archive file

zip, tar

3D File

support for geometric file: .ply, .obj, .stl

Video format

support for multiples image preview of video: .mp4, .flv, .webm, .ogv, .wmv, etc.

Last updated: January 11, 2019

DOC to Image · DOCX to Image · FLV-Video to Image · JPEG to Image · MP4-Video to Image · OBJ (3D File) to Image · ODT to Image · OGG (Video) to Image · PDF to Image · PNG to Image · STL (3D File) to Image · TAR-Archive to Image · TIFF to Image · TXT to Image · WEBM (Video) to Image · WMV (Video) to Image · ZIP-Archive to Image