support Contact Support | system status System Status
Page Contents

    Playlist Fields Reference

    This is a reference to playlist fields returned by the Playback API.

    Primary fields

    Table 1: Primary Fields
    Field Type Default Description
    id string none the playlist id
    account_id string none the id of the account
    created_at ISO 8601 date-time string none date-time video was added to the account; example: "2014-12-09T06:07:11.877Z"
    description string null the short description of the video - 128 single-byte characters maximum
    favorite boolean false whether the playlist is included in favorites
    limit number 100 number of videos the playlist can hold (integer, 1 - 100) returned for Smart Playlists only
    name string none Playlist title - required field
    reference_id string null any value that is unique within the account
    search string null search string used to define the videos for a Smart playlist (example: +tags:"bird","birds")
    type string the type of playlist See note[1] below
    updated_at ISO 8601 date-time string none date-time playlist was last modified; example: "2015-01-13T17:45:21.977Z"
    videos array array of video objects for the videos in the playlist only the first 20 videos are returned for playlists

    Notes

    • [1]

      The type value can only be one of: EXPLICIT, ACTIVATED_OLDEST_TO_NEWEST, ACTIVATED_NEWEST_TO_OLDEST, ALPHABETICAL, PLAYS_TOTAL, PLAYS_TRAILING_WEEK, START_DATE_OLDEST_TO_NEWEST,START_DATE_NEWEST_TO_OLDEST

      EXPLICIT means that it is a manual playlist; all the other types are smart playlists with names corresponding to their ordering scheme.


    Page last updated on 12 Jun 2020