To create a video, you create its container¶meters first, before adding the video file (exception - when using an existing HTTP source).

  • Videos are public by default. Learn about Private videos
  • Up to 6 responsive video streams will be created (from 240p to 4k)
  • Mp4 encoded versions are created at the highest quality (max 1080p) by default.
  • Panoramic videos are for videos recorded in 360 degrees. You can toggle this after your 360 video upload.
  • Searchable parameters: title, description, tags and metadata
$ curl https://ws.api.video/videos \ -H 'Authorization: Bearer {access_token} \ -d '{"title":"My video", 
    "description":"so many details",
    "mp4Support":true
}'

add an URL to upload on creation

You can also create a video directly from a video hosted on a third-party server by giving its URI in source parameter:

$ curl https://ws.api.video/videos \
-H 'Authorization: Bearer {access_token} \
-d '{"source":"http://uri/to/video.mp4", "title":"My video"}'

In this case, the service will respond 202 Accepted and ingest the video asynchronously.

Track users with Dynamic Metadata

Metadata values can be a key:value where the values are predefined, but Dynamic metadata allows you to enter any value for a defined key. To defined a dynamic metadata pair use:
"metadata":[{"dynamicKey": "__dynamicKey__"}]

The double underscore on both sides of the value allows any variable to be added for a given video session. Added the the url you might have:
<iframe type="text/html" src="https://embed.api.video/vod/vi6QvU9dhYCzW3BpPvPsZUa8?metadata[classUserName]=Doug" width="960" height="320" frameborder="0" scrollling="no"></iframe>

This video session will be tagged as watched by Doug - allowing for in-depth analysis on how each viewer interacts with the videos.

We have tutorials on:

Language
Authentication
Bearer
Response
Click Try It! to start a request and see the response here!