Get Playlist By Handle and Slug

GET /playlists/by_permalink/:handle/:slug

Get a playlist by handle and slug

Request

Path Parameters

handle stringrequired

playlist owner handle

slug stringrequired

playlist slug

Query Parameters

user_id string

The user ID of the user making the request

Responses

Success

application/json

Schema
Example

Schema

dataobject[]

Array [

artworkobject

150x150 string

480x480 string

1000x1000 string

description string

permalink stringrequired

id stringrequired

is_album booleanrequired

is_image_autogenerated booleanrequired

playlist_name stringrequired

playlist_contents
object[]required

Array [

metadata_timestamp integerrequired

timestamp integerrequired

track_id stringrequired

]

repost_count integerrequired

favorite_count integerrequired

total_play_count integerrequired

userobjectrequired

album_count integerrequired

artist_pick_track_id string

bio string

cover_photo
object

640x string

2000x string

followee_count integerrequired

follower_count integerrequired

handle stringrequired

id stringrequired

is_verified booleanrequired

twitter_handle string

instagram_handle string

tiktok_handle string

verified_with_twitter booleanrequired

verified_with_instagram booleanrequired

verified_with_tiktok booleanrequired

website string

donation string

location string

name stringrequired

playlist_count integerrequired

profile_picture
object

150x150 string

480x480 string

1000x1000 string

repost_count integerrequired

track_count integerrequired

is_deactivated booleanrequired

is_available booleanrequired

erc_wallet stringrequired

spl_wallet stringrequired

spl_usdc_payout_wallet string

supporter_count integerrequired

supporting_count integerrequired

total_audio_balance integerrequired

wallet stringrequired

The user's Ethereum wallet address for their account

ddex_app string

accessobjectrequired

stream booleanrequired

download booleanrequired

upc string

track_count integerrequired

]

{
  "data": [
    {
      "artwork": {
        "150x150": "https://creatornode.audius.prod-eks-ap-northeast-1.staked.cloud/content/QmdYWfK6sHySGVzYBt12UVXU26Mw8ZcgG2EpVppjQDiXTi/150x150.jpg",
        "480x480": "https://creatornode.audius.prod-eks-ap-northeast-1.staked.cloud/content/QmdYWfK6sHySGVzYBt12UVXU26Mw8ZcgG2EpVppjQDiXTi/480x480.jpg",
        "1000x1000": "https://creatornode.audius.prod-eks-ap-northeast-1.staked.cloud/content/QmdYWfK6sHySGVzYBt12UVXU26Mw8ZcgG2EpVppjQDiXTi/1000x1000.jpg"
      },
      "description": "So you were listening to Pollen on Spotify, but then you got bored, so you came here and chilled the fuck out.\n\nCover: Rome in Silver",
      "permalink": "/rayjacobson/playlist/bees-knees-🐝-4327",
      "id": "DE0xw",
      "is_album": false,
      "is_image_autogenerated": false,
      "playlist_name": "Bees Knees 🐝",
      "playlist_contents": [
        {
          "metadata_timestamp": 1578949505,
          "timestamp": 1578949505,
          "track_id": "ep58M"
        },
        {
          "metadata_timestamp": 1578951625,
          "timestamp": 1578951625,
          "track_id": "n3OP0"
        },
        {
          "metadata_timestamp": 1579134700,
          "timestamp": 1579134700,
          "track_id": "nZpAa"
        },
        {
          "metadata_timestamp": 1578950415,
          "timestamp": 1578950415,
          "track_id": "nd9k4"
        },
        {
          "metadata_timestamp": 1581447220,
          "timestamp": 1581447220,
          "track_id": "eYRWr"
        },
        {
          "metadata_timestamp": 1581613900,
          "timestamp": 1581613900,
          "track_id": "LKvrz"
        },
        {
          "metadata_timestamp": 1580493765,
          "timestamp": 1580493765,
          "track_id": "eYyVp"
        },
        {
          "metadata_timestamp": 1579048000,
          "timestamp": 1579048000,
          "track_id": "D9lkL"
        },
        {
          "metadata_timestamp": 1580242060,
          "timestamp": 1580242060,
          "track_id": "DNoQY"
        },
        {
          "metadata_timestamp": 1580931550,
          "timestamp": 1580931550,
          "track_id": "nkAw3"
        },
        {
          "metadata_timestamp": 1580931740,
          "timestamp": 1580931740,
          "track_id": "DvAlV"
        },
        {
          "metadata_timestamp": 1580931820,
          "timestamp": 1580931820,
          "track_id": "ePlke"
        },
        {
          "metadata_timestamp": 1582761780,
          "timestamp": 1582761780,
          "track_id": "nQ5vW"
        },
        {
          "metadata_timestamp": 1583785730,
          "timestamp": 1583785730,
          "track_id": "ebr7W"
        },
        {
          "metadata_timestamp": 1586289135,
          "timestamp": 1586289135,
          "track_id": "n3kOk"
        },
        {
          "metadata_timestamp": 1586891805,
          "timestamp": 1586891805,
          "track_id": "nlxYO"
        },
        {
          "metadata_timestamp": 1587060500,
          "timestamp": 1587060500,
          "track_id": "DNbp4"
        },
        {
          "metadata_timestamp": 1587501650,
          "timestamp": 1587501650,
          "track_id": "nkYdp"
        },
        {
          "metadata_timestamp": 1587502270,
          "timestamp": 1587502270,
          "track_id": "DEdVM"
        },
        {
          "metadata_timestamp": 1587502970,
          "timestamp": 1587502970,
          "track_id": "DrVJg"
        },
        {
          "metadata_timestamp": 1587972975,
          "timestamp": 1587972975,
          "track_id": "nooaa"
        },
        {
          "metadata_timestamp": 1588711530,
          "timestamp": 1588711530,
          "track_id": "em9By"
        },
        {
          "metadata_timestamp": 1592339080,
          "timestamp": 1592339080,
          "track_id": "nQ1lW"
        },
        {
          "metadata_timestamp": 1594104770,
          "timestamp": 1594104770,
          "track_id": "nqY2z"
        },
        {
          "metadata_timestamp": 1594251095,
          "timestamp": 1594251095,
          "track_id": "nV3wa"
        },
        {
          "metadata_timestamp": 1597782575,
          "timestamp": 1597782575,
          "track_id": "MaEao"
        },
        {
          "metadata_timestamp": 1598635030,
          "timestamp": 1598635030,
          "track_id": "XBRpp"
        },
        {
          "metadata_timestamp": 1603132585,
          "timestamp": 1603132585,
          "track_id": "lz4kA"
        },
        {
          "metadata_timestamp": 1603478465,
          "timestamp": 1603478465,
          "track_id": "w7yl5"
        },
        {
          "metadata_timestamp": 1616537285,
          "timestamp": 1616537285,
          "track_id": "KEwWO"
        },
        {
          "metadata_timestamp": 1619721750,
          "timestamp": 1619721750,
          "track_id": "BqVRx"
        },
        {
          "metadata_timestamp": 1620250295,
          "timestamp": 1620250295,
          "track_id": "E74wM"
        },
        {
          "metadata_timestamp": 1622760065,
          "timestamp": 1622760065,
          "track_id": "pPoMG"
        },
        {
          "metadata_timestamp": 1622827050,
          "timestamp": 1622827050,
          "track_id": "KVBal"
        },
        {
          "metadata_timestamp": 1624087755,
          "timestamp": 1624087755,
          "track_id": "g64zZ"
        },
        {
          "metadata_timestamp": 1625267300,
          "timestamp": 1625267300,
          "track_id": "YYmRq"
        },
        {
          "metadata_timestamp": 1626567410,
          "timestamp": 1626567410,
          "track_id": "xQaEz"
        },
        {
          "metadata_timestamp": 1631124775,
          "timestamp": 1631124775,
          "track_id": "JbJbd"
        },
        {
          "metadata_timestamp": 1632959455,
          "timestamp": 1632959455,
          "track_id": "BqNKP"
        },
        {
          "metadata_timestamp": 1641597545,
          "timestamp": 1641597545,
          "track_id": "y9kjx"
        },
        {
          "metadata_timestamp": 1641599010,
          "timestamp": 1641599010,
          "track_id": "Wx9do"
        },
        {
          "metadata_timestamp": 1642490690,
          "timestamp": 1642490690,
          "track_id": "aBydo"
        },
        {
          "metadata_timestamp": 1643269910,
          "timestamp": 1643269910,
          "track_id": "WkRqj"
        },
        {
          "metadata_timestamp": 1644013040,
          "timestamp": 1644013040,
          "track_id": "z9Mpw"
        },
        {
          "metadata_timestamp": 1650132350,
          "timestamp": 1650132350,
          "track_id": "Zr6Pg"
        },
        {
          "metadata_timestamp": 1650405290,
          "timestamp": 1650405290,
          "track_id": "l5BkN"
        },
        {
          "metadata_timestamp": 1659567985,
          "timestamp": 1659567985,
          "track_id": "PV1d7"
        },
        {
          "metadata_timestamp": 1666471475,
          "timestamp": 1666471475,
          "track_id": "azggz"
        },
        {
          "metadata_timestamp": 1668490685,
          "timestamp": 1668490685,
          "track_id": "vl6Zm"
        },
        {
          "metadata_timestamp": 1668791270,
          "timestamp": 1668791270,
          "track_id": "K5lEr"
        },
        {
          "metadata_timestamp": 1689054594,
          "timestamp": 1689054597,
          "track_id": "y8118Ox"
        },
        {
          "metadata_timestamp": 1689796549,
          "timestamp": 1689796552,
          "track_id": "J85gW1k"
        },
        {
          "metadata_timestamp": 1690223867,
          "timestamp": 1690223870,
          "track_id": "bddzdXk"
        }
      ],
      "repost_count": 12,
      "favorite_count": 22,
      "total_play_count": 948140,
      "user": {
        "album_count": 1,
        "artist_pick_track_id": null,
        "bio": "▵◢▾◀▲⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢▾◀▲\n⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢▾\n◀▲⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢▾◀\n▲⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢\n▾◀▲⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢▾◀▲⎊⧎◮▵◢▾\n◀▲⎊⧎◮▵◢▾◀▲⎊⧎◮",
        "cover_photo": {
          "640x": "https://audius-content-14.figment.io/content/QmTWrFnHee8ErDokb5vDtEcGercaZXQJYwY9ahjQTWdrVs/640x.jpg",
          "2000x": "https://audius-content-14.figment.io/content/QmTWrFnHee8ErDokb5vDtEcGercaZXQJYwY9ahjQTWdrVs/2000x.jpg"
        },
        "followee_count": 1707,
        "follower_count": 8572,
        "handle": "rayjacobson",
        "id": "7eP5n",
        "is_verified": false,
        "twitter_handle": "raymondjacobson",
        "instagram_handle": "raymondjacobson",
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": null,
        "donation": "NAACP - https://www.naacp.org/Donate",
        "location": "chik fil yay!",
        "name": "raymont",
        "playlist_count": 10,
        "profile_picture": {
          "150x150": "https://usermetadata.audius.co/content/QmYRHAJ4YuLjT4fLLRMg5STnQA4yDpiBmzk5R3iCDTmkmk/150x150.jpg",
          "480x480": "https://usermetadata.audius.co/content/QmYRHAJ4YuLjT4fLLRMg5STnQA4yDpiBmzk5R3iCDTmkmk/480x480.jpg",
          "1000x1000": "https://usermetadata.audius.co/content/QmYRHAJ4YuLjT4fLLRMg5STnQA4yDpiBmzk5R3iCDTmkmk/1000x1000.jpg"
        },
        "repost_count": 4666,
        "track_count": 17,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x7d273271690538cf855e5b3002a0dd8c154bb060",
        "spl_wallet": "EXfHYvqN7GTeQa7aiRhq4UMMZBC9PmUXmskgCH7BSaTn",
        "supporter_count": 16,
        "supporting_count": 170,
        "total_audio_balance": 99,
        "wallet": "0x7d273271690538cf855e5b3002a0dd8c154bb060"
      },
      "ddex_app": null,
      "access": {
        "stream": true,
        "download": true
      },
      "upc": null,
      "track_count": 53
    }
  ]
}

Get Playlist By Handle and Slug

/playlists/by_permalink/:handle/:slug

Request​

Path Parameters

Query Parameters

Responses​

Request

Responses