Streamable API

0. Authentication

Usage of the API requires a Streamable account and valid email. All requests must be authenticated with Basic Auth. If you're a bot, please provide a descriptive user agent as well.

1. Create a video

You can either upload a video file or send us a link. Each endpoint returns a JSON payload that will include the created video's shortcode.

POST https://api.streamable.com/upload

curl https://api.streamable.com/upload
        -u email:password
        -F file=@myvideo.mp4

GET https://api.streamable.com/import{?url}

curl https://api.streamable.com/import?url=http://www.sample-videos.com/video/mp4/720/big_buck_bunny_720p_1mb.mp4
        -u email:password

2. Retrieve a video

To play your video, retrieve the embed code using oEmbed (for web applications) or raw mp4 file using the /videos endpoint (for native applications). Web applications must use the embedded Streamable player.

GET https://api.streamable.com/oembed.json{?url}

curl https://api.streamable.com/oembed.json?url=https://streamable.com/moo

GET https://api.streamable.com/videos/{shortcode}

curl https://api.streamable.com/videos/moo -u email:password

3. Control the video player

The embed code renders the video player inside a responsive iFrame. You can control the player using Player.js.