/videos/show

Show the properties of a given video.

Parameters

video_key : string

Key of the video which information to show.

Example response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <video key="yYul4DRz">
    <author>JW Platform</author>
    <custom>
      <param1>value 1</param1>
      <param2>value 2</param2>
    </custom>
    <date>1225962900</date>
    <description>New video</description>
    <duration>12.0</duration>
    <expires_date>1459908560</expires_date>
    <error>
      <message>Unsupported format</message>
    </error>
    <link>http://www.jwplatform.com</link>
    <md5>b2d7312bd39cc60e9facc8ed3cbb6418</md5>
    <mediatype>video</mediatype>
    <protectionrule_key>aBcdEf82</protectionrule_key>
    <size>29478520</size>
    <sourceformat />
    <sourcetype>file</sourcetype>
    <sourceurl />
    <status>ready</status>
    <tags>new, video</tags>
    <title>New test video</title>
    <updated>1225968700</updated>
    <upload_session_id />
    <views>123</views>
  </video>
</response>

Response parameters

/response/status : string

Call execution status. Set to ok if call executed successfully.

//video/@key : string

Video key.

//video/author : string

Author of the video.

//video/custom/param1 : string

User-defined parameter.

//video/date : signed integer

Video publish date. Specifies UTC date and time (in Unix timestamp format) when the video will be available for streaming.

//video/expires_date : signed integer

Video publish expiration date. Specifies UTC date and time (in Unix timestamp format) when the video will stop being available for streaming.

//video/description : string

Description of the video.

//video/duration : float

Duration of the video in seconds.

//video/link : string

The URL of the web page where this video is published.

//video/md5 : string

MD5 hash of the original file.

//video/mediatype : string

Content media type:

unknown

Media type is unknown.

audio

Media type is audio.

video

Media type is video.

//video/protectionrule_key : string

Protection Rule key applied to the video.

//video/size : unsigned integer

Combined size of all conversions created for this video in bytes.

//video/sourceformat : string
Video source format:
mp4
Video MIME type is video/mp4.
webm

Video MIME type is video/webm.

flv

Video MIME type is video/flv.

aac

Audio MIME type is audio/aac.

mp3

Audio MIME type is audio/mpeg.

vorbis

Audio MIME type is type audio/ogg.

m3u8

For a HLS M3U8 manifest URL.

smil

For a SMIL manifest URL.

//video/sourcetype : string

Source type of the video:

file

Video source type is file.

//video/status : string

Video status:

created

Video is created. Waiting for the original file upload being complete.

processing

Original file or default conversion is being processed.

ready

Video ready for streaming (original and default conversion are ready).

updating

New (re-uploaded) original file is being processed. Previous original file and default conversion are ready for streaming.

failed

Processing of the original file or default conversion has failed.

//video/error : string

Not empty if processing of the initial or re-uploaded original file or their default conversion has failed.

//video/error/message : string

Error message.

When //video/status is failed, error message corresponds to the initially uploaded original file or its default conversion, or to the last re-uploaded original file or its default conversion (if initial upload also has failed).

When //video/status is ready, error message corresponds to the last re-uploaded original file or its default conversion.

//video/tags : string

Tags of the video.

//video/title : string

Title of the video.

//video/updated : signed integer

Video update date. Specifies UTC date and time (in Unix timestamp format) when the video was updated for the last time.

//video/upload_session_id : string

Resumable upload session ID.

//video/views : unsigned integer

DEPRECATED Total video views since video has been created.

Warning

Views is a legacy system metric that has been deprecated since 2016-07-01. The value returned here is not an accurate representation of video views or plays.