List Playlists by Owner

Retrieves information about public-facing playlists for use by a player.

Request

Request syntax:

https://content.uplynk.com/api/v4/player/owners/{user_id}/playlists

Response

The response for a successful request contains a list of the following parameters:

Response ParameterTypeDescription
@idStringThe URL containing the Playlist ID (has to be unique for the items returned)
@typeStringAlways set to "Playlist"
idStringThe Playlist ID by itself
descStringThe name of the playlist
total_durationIntegerDuration of the playlist including optional ad breaks in seconds
timeline_durationIntegerDuration of the playlist not including optional ad breaks in seconds
poster_urlStringThe URL of the poster art
urlStringThe URL of the playlist without playback token (better to use this than @id)

Sample Response

The following sample response contains information about the list of public-facing playlists.

{
  "@id": "/api/v4/player/owners/0933a56ee6f5434c8ffe5e0099999999/playlists",
  "@type": "Collection",
  "items": [
    {
      "@id": "https://content-ausw2-up-1.uplynk.com/api/v4/player/playlists/d2ca1b9e717242908e42afe8f2f11263",
      "@type": "Playlist",
      "id": "d2ca1b9e717242908e42afe8f2f11263",
      "desc": "Main Playlist",
      "total_duration": 6116,
      "timeline_duration": 5126,
      "poster_url": "http://cf.cdn.uplynk.com/ause2/playlists/d2ca1b9e717242908e42afe8f2f11263/posters/tmpx8h_ewy6.jpg",
      "url": "https://content-ausw2-up-1.uplynk.com/api/v4/player/playlists/d2ca1b9e717242908e42afe8f2f11263"
    },
    {
      "@id": "https://content-ausw2-up-1.uplynk.com/api/v4/player/playlists/516184ef80be442697d0c14abfd87c99",
      "@type": "Playlist",
      "id": "516184ef80be442697d0c14abfd87c99",
      "desc": "Test Playlist",
      "total_duration": 1584,
      "timeline_duration": 1554,
      "poster_url": "http://cf.cdn.uplynk.com/ause1/playlists/516184ef80be442697d0c14abfd87c99/posters/tmpkdbnkfkv.jpg",
      "url": "https://content-ausw2-up-1.uplynk.com/api/v4/player/playlists/516184ef80be442697d0c14abfd87c99"
    },
}