Get Bulk Playlists

GET 
/playlists

Gets a list of playlists by ID

Request

Query Parameters

user_id string

The user ID of the user making the request

id string[]

The ID of the playlist(s)

Responses

200

Success

application/json

Schema

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

]

Example

{
  "data": [
    {
      "artwork": {
        "150x150": "https://usermetadata.audius.co/content/QmbFqAracsZrrcpxSu64StTiaX8rHJBVsRCqdTH9ob5HDZ/150x150.jpg",
        "480x480": "https://usermetadata.audius.co/content/QmbFqAracsZrrcpxSu64StTiaX8rHJBVsRCqdTH9ob5HDZ/480x480.jpg",
        "1000x1000": "https://usermetadata.audius.co/content/QmbFqAracsZrrcpxSu64StTiaX8rHJBVsRCqdTH9ob5HDZ/1000x1000.jpg"
      },
      "description": null,
      "permalink": "/BAES/playlist/melancholia-9259",
      "id": "ngY3k",
      "is_album": false,
      "is_image_autogenerated": false,
      "playlist_name": "Melancholia",
      "playlist_contents": [
        
      ],
      "repost_count": 8,
      "favorite_count": 16,
      "total_play_count": 2266,
      "user": {
        "album_count": 0,
        "artist_pick_track_id": "V44ZW",
        "bio": "Big boy trying to make big moves",
        "cover_photo": {
          "640x": "https://blockdaemon-audius-content-05.bdnodes.net/content/Qmb7rDudz6XxibNEeAKQpK67x9AkDCyQJZjG3LKtueWKsN/640x.jpg",
          "2000x": "https://blockdaemon-audius-content-05.bdnodes.net/content/Qmb7rDudz6XxibNEeAKQpK67x9AkDCyQJZjG3LKtueWKsN/2000x.jpg"
        },
        "followee_count": 180,
        "follower_count": 659,
        "handle": "BAES",
        "id": "eJBpe",
        "is_verified": false,
        "twitter_handle": "baesisdreaming",
        "instagram_handle": null,
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": null,
        "donation": null,
        "location": "Canada",
        "name": "BÆS",
        "playlist_count": 1,
        "profile_picture": {
          "150x150": "https://audius-content-16.cultur3stake.com/content/Qmc2Fiy7uMzZgVGKkdwwK8qkeaeE9Dd9fHo6XBCNggnTr3/150x150.jpg",
          "480x480": "https://audius-content-16.cultur3stake.com/content/Qmc2Fiy7uMzZgVGKkdwwK8qkeaeE9Dd9fHo6XBCNggnTr3/480x480.jpg",
          "1000x1000": "https://audius-content-16.cultur3stake.com/content/Qmc2Fiy7uMzZgVGKkdwwK8qkeaeE9Dd9fHo6XBCNggnTr3/1000x1000.jpg"
        },
        "repost_count": 86,
        "track_count": 17,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0xc0c8f72b31a3d5a0acd48db358faf71b4dc0d3eb",
        "spl_wallet": "DeA73bEYfhwoqmQRoAuKcATrCdcbjJNvd1z4ardt44WD",
        "supporter_count": 0,
        "supporting_count": 0,
        "total_audio_balance": 1,
        "wallet": "0xc0c8f72b31a3d5a0acd48db358faf71b4dc0d3eb"
      },
      "ddex_app": null,
      "access": {
        "stream": true,
        "download": true
      },
      "upc": null,
      "track_count": 11
    },
    {
      "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": [
        
      ],
      "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
    }
  ]
}

400

Bad request

500

Server error

Loading...