The playlist object

Curated playlists are collections of songs or sound effects. Use the include parameter on the playlist endpoints to return their associated resources in the top-level included array.

When songs are included, each uses the shared song object, including its isrc attribute.

Attributes

AttributeTypeDescription
descriptionstringPlaylist description
durationnumberThe combined length of all songs in the playlist in seconds
imagestringPlaylist image URL. The w and h query string parameters (both 450px by default) can be updated to change the width and height of the image, respectively. Removing these parameters will return the full-resolution image.
namestringPlaylist name

Example

{
  "id": "1",
  "type": "playlist",
  "attributes": {
    "name": "Staff Picks",
    "description": "Personal favorites chosen by the smiling staffers at Soundstripe.",
    "image": "https://soundstripe-production.imgix.net/uploads/playlist/3510/pic/665be1aafc.png?w=450&h=450",
    "duration": 190226.0
  },
  "relationships": {
    "songs": {
      "data": [
        {
          "id": "12516",
          "type": "songs"
        },
        {
          "id": "12419",
          "type": "songs"
        }
      ]
    },
    "playlist_categories": {
      "data": [
        {
          "id": "7",
          "type": "playlist_categories"
        }
      ]
    }
  }
}