/channels/videos/list

Return list of videos in a channel. This endpoint only applies to manual and dynamic channels.

Warning

The response from this call will not reflect the behavior of dynamic channels ordered by views. Views is a legacy system metric that has been deprecated since 2016-07-01. Channels ordered by views return results based on 30 day play count.

Parameters

channel_key : string

Key of the channel which videos should be listed.

result_limit (optional): unsigned integer

Specifies maximum number of videos to return. Default is 50. Maximum result limit is 1000.

result_offset (optional): unsigned integer

Specifies how many videos should be skipped at the beginning of the result set. Default is 0.

Example response

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</status>
  <limit>50</limit>
  <offset>0</offset>
  <total>2</total>
  <videos total="2">
    <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>
      <link>http://www.jwplatform.com</link>
      <md5>b2d7312bd39cc60e9facc8ed3cbb6418</md5>
      <mediatype>video</mediatype>
      <tags>new, video</tags>
      <title>New test video</title>
      <views>123</views>
    </video>
    ...
  </videos>
</response>

Response parameters

/response/status : string

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

/response/limit : unsigned integer

Maximum number of videos that should be return. As specified in the result_limit request parameter.

/response/offset : unsigned integer

Number of videos that should be skipped at the beginning of the result set. As specified in the result_offset request parameter.

/response/total : unsigned integer

Total number of videos available in the channel.

/videos/@total : unsigned integer

Total number of returned videos.

//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/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:

audio

Media type is audio.

video

Media type is video.

//video/tags : string

Tags of the video.

//video/title : string

Title of the video.

//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.