Get Trending Playlists

GET 
/playlists/trending

Gets trending playlists for a time period

Request

Query Parameters

time string

Possible values: [week, month, year, allTime]

Calculate trending over a specified time range

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://cn4.mainnet.audiusindex.org/content/01J4Z0HEG7KX9EDP77M4D534DF/150x150.jpg",
        "480x480": "https://cn4.mainnet.audiusindex.org/content/01J4Z0HEG7KX9EDP77M4D534DF/480x480.jpg",
        "1000x1000": "https://cn4.mainnet.audiusindex.org/content/01J4Z0HEG7KX9EDP77M4D534DF/1000x1000.jpg"
      },
      "description": "Beautiful things will land in this list.",
      "permalink": "/KarmasPlayground/playlist/beautiful-tranquility",
      "id": "WbZkR6K",
      "is_album": false,
      "is_image_autogenerated": false,
      "playlist_name": "Beautiful Tranquility",
      "playlist_contents": [
        {
          "metadata_timestamp": null,
          "timestamp": null,
          "track_id": null
        }
      ],
      "repost_count": 19,
      "favorite_count": 26,
      "total_play_count": 200664,
      "user": {
        "album_count": 0,
        "artist_pick_track_id": null,
        "bio": "Might know me as Karmatrain379\nbeen vibin a long time\nstarted this account to\nbetter support @audius and its epic epic artists. I make lists to come back to. My @karmatrain379 is Active but ThePlayground is a new wave of lists. 🌧☀🥀🌹🌹\nmay we all grow🦋",
        "cover_photo": null,
        "followee_count": 735,
        "follower_count": 97,
        "handle": "KarmasPlayground",
        "id": "Zqa2jE",
        "is_verified": false,
        "twitter_handle": "karmatrain379",
        "instagram_handle": "karmatrain379",
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": null,
        "donation": null,
        "location": "NL,CANADA",
        "name": "🦋🦋ThePlayground🦋🦋",
        "playlist_count": 13,
        "profile_picture": {
          "150x150": "https://blockchange-audius-content-01.bdnodes.net/content/01J338GV2D902RSMRSGXHCH9Y6/150x150.jpg",
          "480x480": "https://blockchange-audius-content-01.bdnodes.net/content/01J338GV2D902RSMRSGXHCH9Y6/480x480.jpg",
          "1000x1000": "https://blockchange-audius-content-01.bdnodes.net/content/01J338GV2D902RSMRSGXHCH9Y6/1000x1000.jpg"
        },
        "repost_count": 5799,
        "track_count": 0,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x912b79c2f86acc103c54a9907f7a9f418e797824",
        "spl_wallet": "AFFSnrdQdbBe5qhYDPw399JC8kQRontGjLagss5WAwYu",
        "supporter_count": 8,
        "supporting_count": 47,
        "total_audio_balance": 173,
        "wallet": "0x912b79c2f86acc103c54a9907f7a9f418e797824"
      },
      "ddex_app": null,
      "access": {
        "stream": true,
        "download": true
      },
      "upc": null,
      "track_count": 22
    },
    {
      "artwork": {
        "150x150": "https://cn1.stuffisup.com/content/01J53D635SE6C5J2JRXCPHT88Q/150x150.jpg",
        "480x480": "https://cn1.stuffisup.com/content/01J53D635SE6C5J2JRXCPHT88Q/480x480.jpg",
        "1000x1000": "https://cn1.stuffisup.com/content/01J53D635SE6C5J2JRXCPHT88Q/1000x1000.jpg"
      },
      "description": "Smells like teen Spirit",
      "permalink": "/Domtell/playlist/😍-house-of-sun😍",
      "id": "M2073Z9",
      "is_album": false,
      "is_image_autogenerated": false,
      "playlist_name": "😍 House of sun😍",
      "playlist_contents": [
        {
          "metadata_timestamp": null,
          "timestamp": null,
          "track_id": null
        }
      ],
      "repost_count": 13,
      "favorite_count": 14,
      "total_play_count": 37419,
      "user": {
        "album_count": 0,
        "artist_pick_track_id": null,
        "bio": "Smalls like teen Spirit",
        "cover_photo": {
          "640x": "https://audius-content-3.figment.io/content/01J2PZ41ZPGWH9ZE0RJMHZAAR0/640x.jpg",
          "2000x": "https://audius-content-3.figment.io/content/01J2PZ41ZPGWH9ZE0RJMHZAAR0/2000x.jpg"
        },
        "followee_count": 388,
        "follower_count": 27,
        "handle": "Domtell",
        "id": "797K8RW",
        "is_verified": false,
        "twitter_handle": "Domtallesmyers",
        "instagram_handle": "domtell1705",
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": null,
        "donation": null,
        "location": "São Paulo, SP",
        "name": "Dom Talles Myers ",
        "playlist_count": 8,
        "profile_picture": {
          "150x150": "https://blockchange-audius-content-03.bdnodes.net/content/01J04MZ9Z60JX9KCPX4XNPTHZ5/150x150.jpg",
          "480x480": "https://blockchange-audius-content-03.bdnodes.net/content/01J04MZ9Z60JX9KCPX4XNPTHZ5/480x480.jpg",
          "1000x1000": "https://blockchange-audius-content-03.bdnodes.net/content/01J04MZ9Z60JX9KCPX4XNPTHZ5/1000x1000.jpg"
        },
        "repost_count": 63,
        "track_count": 30,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x34d53f654ad8d37c505ad7aac239d65cc34e372e",
        "spl_wallet": "3Re5ykf2Xpe6xKcJ9owiNuCDNgWe3pjSpWb1WnRX4H8D",
        "supporter_count": 3,
        "supporting_count": 0,
        "total_audio_balance": 207,
        "wallet": "0x34d53f654ad8d37c505ad7aac239d65cc34e372e"
      },
      "ddex_app": null,
      "access": {
        "stream": true,
        "download": true
      },
      "upc": null,
      "track_count": 5
    },
    {
      "artwork": {
        "150x150": "https://blockdaemon-audius-content-02.bdnodes.net/content/QmfK4YJTCghQCyh5aWFR9irBUNb1uwwcdPg7L6Jb1Q9dyv/150x150.jpg",
        "480x480": "https://blockdaemon-audius-content-02.bdnodes.net/content/QmfK4YJTCghQCyh5aWFR9irBUNb1uwwcdPg7L6Jb1Q9dyv/480x480.jpg",
        "1000x1000": "https://blockdaemon-audius-content-02.bdnodes.net/content/QmfK4YJTCghQCyh5aWFR9irBUNb1uwwcdPg7L6Jb1Q9dyv/1000x1000.jpg"
      },
      "description": "A collection of some of the noicest Synthwave, Retrowave and Outrun songs on Audius",
      "permalink": "/milesmatrix/playlist/essential-synthwave-17277",
      "id": "LjErB",
      "is_album": false,
      "is_image_autogenerated": false,
      "playlist_name": "Essential Synthwave",
      "playlist_contents": [
        {
          "metadata_timestamp": null,
          "timestamp": null,
          "track_id": null
        }
      ],
      "repost_count": 46,
      "favorite_count": 74,
      "total_play_count": 17374,
      "user": {
        "album_count": 4,
        "artist_pick_track_id": "qG1qE",
        "bio": "Miles Matrix is a Synthwave producer from Vienna.\n\nHis Synthwave universe draws inspiration from Cyberpunk, 80s movie and video game soundtracks.",
        "cover_photo": {
          "640x": "https://blockchange-audius-content-02.bdnodes.net/content/QmWfeFJfAy5fND9rcdku9jbJHUVEJB1bP2XrsBk5QqPATM/640x.jpg",
          "2000x": "https://blockchange-audius-content-02.bdnodes.net/content/QmWfeFJfAy5fND9rcdku9jbJHUVEJB1bP2XrsBk5QqPATM/2000x.jpg"
        },
        "followee_count": 278,
        "follower_count": 722,
        "handle": "milesmatrix",
        "id": "DvREp",
        "is_verified": false,
        "twitter_handle": "arcadeglitch_",
        "instagram_handle": "arcadeglitch_",
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": "arcadeglitch.com",
        "donation": null,
        "location": "Vienna",
        "name": "Miles Matrix",
        "playlist_count": 1,
        "profile_picture": {
          "150x150": "https://audius-content-18.cultur3stake.com/content/Qme1u7DcMq3xFeYfnjGM1ZyRXPGi14vR4kQF6F1ufCHB5C/150x150.jpg",
          "480x480": "https://audius-content-18.cultur3stake.com/content/Qme1u7DcMq3xFeYfnjGM1ZyRXPGi14vR4kQF6F1ufCHB5C/480x480.jpg",
          "1000x1000": "https://audius-content-18.cultur3stake.com/content/Qme1u7DcMq3xFeYfnjGM1ZyRXPGi14vR4kQF6F1ufCHB5C/1000x1000.jpg"
        },
        "repost_count": 46,
        "track_count": 28,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x2e745932e7ba691310b3d3ac5d72b1a80d695111",
        "spl_wallet": "nwDY9LVFP95LY4Y1Z8vWhhdinEwqg2woeWJeSnNWAgV",
        "supporter_count": 0,
        "supporting_count": 0,
        "total_audio_balance": 4,
        "wallet": "0x2e745932e7ba691310b3d3ac5d72b1a80d695111"
      },
      "ddex_app": null,
      "access": {
        "stream": true,
        "download": true
      },
      "upc": null,
      "track_count": 48
    },
    {
      "artwork": {
        "150x150": "https://cn1.stuffisup.com/content/01HVXEC63VY9ME7YCBHKHVB33C/150x150.jpg",
        "480x480": "https://cn1.stuffisup.com/content/01HVXEC63VY9ME7YCBHKHVB33C/480x480.jpg",
        "1000x1000": "https://cn1.stuffisup.com/content/01HVXEC63VY9ME7YCBHKHVB33C/1000x1000.jpg"
      },
      "description": "",
      "permalink": "/edditter/playlist/synthwave-horizon",
      "id": "0d7Wj5m",
      "is_album": false,
      "is_image_autogenerated": false,
      "playlist_name": "Synthwave Horizon",
      "playlist_contents": [
        {
          "metadata_timestamp": null,
          "timestamp": null,
          "track_id": null
        }
      ],
      "repost_count": 29,
      "favorite_count": 37,
      "total_play_count": 32333,
      "user": {
        "album_count": 7,
        "artist_pick_track_id": "9PWoyWj",
        "bio": "❤️ Sounds for romantic pterodactyls 🎶",
        "cover_photo": {
          "640x": "https://audius-creator-2.theblueprint.xyz/content/QmShSQ91mU66KMw8pe9QKv7CrYYwEnn5JidDxXZV3ToVZy/640x.jpg",
          "2000x": "https://audius-creator-2.theblueprint.xyz/content/QmShSQ91mU66KMw8pe9QKv7CrYYwEnn5JidDxXZV3ToVZy/2000x.jpg"
        },
        "followee_count": 367,
        "follower_count": 5252,
        "handle": "edditter",
        "id": "3AOQE",
        "is_verified": false,
        "twitter_handle": null,
        "instagram_handle": "https://www.instagram.com/edditter/",
        "tiktok_handle": null,
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": "https://open.spotify.com/track/07Osuhi9hYn9tL54qRQwRw?si=5415930de1404ef1  ",
        "donation": null,
        "location": "",
        "name": "eddie edditter",
        "playlist_count": 144,
        "profile_picture": {
          "150x150": "https://creatornode.audius3.prod-eks-ap-northeast-1.staked.cloud/content/QmPKQV3Kzk2VPj5Xx5uyKmqZs8ejbn5CMSUrq4mMs1CZKA/150x150.jpg",
          "480x480": "https://creatornode.audius3.prod-eks-ap-northeast-1.staked.cloud/content/QmPKQV3Kzk2VPj5Xx5uyKmqZs8ejbn5CMSUrq4mMs1CZKA/480x480.jpg",
          "1000x1000": "https://creatornode.audius3.prod-eks-ap-northeast-1.staked.cloud/content/QmPKQV3Kzk2VPj5Xx5uyKmqZs8ejbn5CMSUrq4mMs1CZKA/1000x1000.jpg"
        },
        "repost_count": 13468,
        "track_count": 180,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x1a76e65c3d1f53ef48ff4cbdb57d26246f833c86",
        "spl_wallet": "8nEZqPYZNTq8Abg9BNhvn7AEdqLGuPh4MRoMhpTqBpNN",
        "supporter_count": 23,
        "supporting_count": 32,
        "total_audio_balance": 6121,
        "wallet": "0x1a76e65c3d1f53ef48ff4cbdb57d26246f833c86"
      },
      "ddex_app": null,
      "access": {
        "stream": true,
        "download": true
      },
      "upc": null,
      "track_count": 24
    },
    {
      "artwork": {
        "150x150": "https://blockdaemon-audius-content-04.bdnodes.net/content/QmWccde4w6ycXJCy6TUc19KzgALVKq1dt85dN3VESD2uR3/150x150.jpg",
        "480x480": "https://blockdaemon-audius-content-04.bdnodes.net/content/QmWccde4w6ycXJCy6TUc19KzgALVKq1dt85dN3VESD2uR3/480x480.jpg",
        "1000x1000": "https://blockdaemon-audius-content-04.bdnodes.net/content/QmWccde4w6ycXJCy6TUc19KzgALVKq1dt85dN3VESD2uR3/1000x1000.jpg"
      },
      "description": "SURPRISE\nStoked to announce ApexClub Remix Contest! Download the stems and join our competition, we have some special prizes.\n\nStems, rules and details here: https://bit.ly/3ClNn98\n\nCant wait to hear your remixes!!!",
      "permalink": "/kumocollective/playlist/remix-contest-gaszia-apexclub-69649",
      "id": "na36r",
      "is_album": false,
      "is_image_autogenerated": false,
      "playlist_name": "REMIX CONTEST: Gaszia - ApexClub",
      "playlist_contents": [
        {
          "metadata_timestamp": null,
          "timestamp": null,
          "track_id": null
        }
      ],
      "repost_count": 11,
      "favorite_count": 24,
      "total_play_count": 5053,
      "user": {
        "album_count": 6,
        "artist_pick_track_id": "WNYwG6Z",
        "bio": "Record label from Italy, established in 2017. \n\nas free as a cloud ☁️\n\nVisit the KUMOverse\nhttps://kumocollective.com",
        "cover_photo": {
          "640x": "https://audius-creator-4.theblueprint.xyz/content/01HQESSDEB8D2S43H8MM4D56D6/640x.jpg",
          "2000x": "https://audius-creator-4.theblueprint.xyz/content/01HQESSDEB8D2S43H8MM4D56D6/2000x.jpg"
        },
        "followee_count": 19,
        "follower_count": 13634,
        "handle": "kumocollective",
        "id": "Lj0ae",
        "is_verified": false,
        "twitter_handle": "KUMOCollective",
        "instagram_handle": "kumocollective",
        "tiktok_handle": "kumocollective",
        "verified_with_twitter": false,
        "verified_with_instagram": false,
        "verified_with_tiktok": false,
        "website": "https://kumocollective.com",
        "donation": null,
        "location": "Amsterdam",
        "name": "KUMO Collective",
        "playlist_count": 11,
        "profile_picture": {
          "150x150": "https://audius-content-11.cultur3stake.com/content/01HJ1FXSNBENNJX4BPMYPKQBTK/150x150.jpg",
          "480x480": "https://audius-content-11.cultur3stake.com/content/01HJ1FXSNBENNJX4BPMYPKQBTK/480x480.jpg",
          "1000x1000": "https://audius-content-11.cultur3stake.com/content/01HJ1FXSNBENNJX4BPMYPKQBTK/1000x1000.jpg"
        },
        "repost_count": 533,
        "track_count": 153,
        "is_deactivated": false,
        "is_available": true,
        "erc_wallet": "0x62b166e2d2c8882e5e624ba1d6eba939424fc3f7",
        "spl_wallet": "5f5AkVbVPFDCVXBr1fcZ7kYaahQEXYYTFuxJ6RDvjeHS",
        "supporter_count": 14,
        "supporting_count": 0,
        "total_audio_balance": 1,
        "wallet": "0x62b166e2d2c8882e5e624ba1d6eba939424fc3f7"
      },
      "ddex_app": null,
      "access": {
        "stream": true,
        "download": true
      },
      "upc": null,
      "track_count": 28
    }
  ]
}

400

Bad request

500

Server error

Loading...