API documentation

Coconut's API is a config-based API built with simplicity and flexibility in mind.
Encode your first video in less than 5 minutes.

API Reference

Coconut's API is a config-based API built with simplicity and flexibility in mind.

The config file is used to describe your entire encoding workflow from transcoding to multiple formats to generating thumbnails of any size. It is then submitted to Coconut for processing. Very simple.

Getting started

We provide client libraries for the most popular languages so that you don't have to reinvent the wheel and you can start right away!


Current API version: 2018-10-17


  • New Add support for every option to generate thumbnails every X seconds.
  • New Add support for sprite option to generate thumbnails into a single sprite image.
  • New Add support for vtt option to create a WebVTT file containing a list of cues and corresponding thumbnails.
  • See previews output


  • New Add support for Widevine, Playready and Fairplay DRM to httpstream.
  • New Add Multiline support to config file to increase readability and maintainability.
  • New Add support for DigitalOcean Spaces (S3 compatible).


  • New httpstream output available. Packaging into HLS, HLSfMP4 and MPEG-Dash.
  • Break hls and dash outputs have been removed in favor of the new httpstream output.
  • New variable $source_ifps: source FPS as integer.


  • New dash output available. Simply add -> dash in the config file to get MPEG-Dash instantly!
  • New fit option for jpg and png output. If fit=crop, the image will be cropped instead padded.
  • New CDN Backblaze B2 supported – Added on January, 19th 2017


  • New events option (boolean) for webhook setting. You will be able to receive a webhook notification each time a source file is transferred, an output is processed and more.
  • New Any custom headers are now supported in the Amazon S3 output URL.
  • New offsets option ([int,]) for jpg and png output. You can now specify the position in second for each thumbnail.


  • New metadata option (boolean) for webhook setting. It is now possible to receive all the metadata of source and output videos in the webhook request.
  • Break Variable source_length renamed to source_duration


Initial release of the API v2. Read our blog post.