Supporting information on the Create video endpoint

To create a video, you create its container & parameters 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

       ```shell
      $ 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: