# Audius

> Audius, the open music streaming platform: search tracks, artists and playlists, follow the trending charts and new uploads, read a track's comments and fans or an artist's followers and top supporters, and get a link to a track's audio. No account or API key required.

App · 20 actions. Web page: https://docs.lodol.com/docs/integrations/audius

## Actions

### Get playlist

Get an Audius playlist or album by its id or link, with every track in it, in order.

**Inputs**

- Playlist or album (`playlist`, text, required): The playlist's or album's Audius id (such as DOPRl, from another Audius step) or its link on audius.co.

**Outputs**

- `artwork_url` (text): The cover art, 480 by 480 pixels, when it has one.
- `created_at` (text): When it was made, ISO 8601 in UTC.
- `description` (text): Its description.
- `favorite_count` (number): How many people favorited it.
- `id` (text): The playlist's Audius id, e.g. 'DOPRl'. Use it in Get playlist.
- `is_album` (true/false): True for an album, false for a playlist.
- `name` (text): The playlist's or album's name.
- `owner_handle` (text): That user's handle.
- `owner_id` (text): The Audius id of the user who made it.
- `owner_name` (text): That user's display name.
- `repost_count` (number): How many people reposted it.
- `total_play_count` (number): How many times its tracks were played in all.
- `track_count` (number): How many tracks it holds.
- `tracks` (list): Every track in it, in order.
- `updated_at` (text): When it last changed, ISO 8601 in UTC.
- `url` (text): Its page on audius.co.

**Example output**

```json
{
  "artwork_url": "https://audius-discovery-2.altego.net/content/01KH6XGYQ8T86WPVSMN21NECWB/480x480.jpg",
  "created_at": "2020-01-11T00:08:35Z",
  "description": "All the latest hot & new tracks on Audius! Buckle in for a trip through various genres featuring artists you love and new artists you are about to discover. \ud83d\udd25",
  "favorite_count": 1705030,
  "id": "DOPRl",
  "is_album": false,
  "name": "Hot & New on Audius\ud83d\udd25",
  "owner_handle": "Audius",
  "owner_id": "eJ57D",
  "owner_name": "Audius",
  "repost_count": 2435,
  "total_play_count": 17062,
  "track_count": 21,
  "tracks": [
    {
      "artist_handle": "radiojuicy",
      "artist_id": "n3YPZ",
      "artist_name": "Radio Juicy",
      "artwork_url": "https://audius-discovery-3.altego.net/content/baeaaaiqseccucl5dyjluubaxfjy4w6pgolmjwncbelflkqnysisy5x44wv3fe/480x480.jpg",
      "bpm": 154,
      "comment_count": 8,
      "created_at": "2026-10-09T14:26:27Z",
      "description": "Radio Juicy is happy to present Tohaj\u2019s new single \u201cLong Drive\u201d, another step toward his upcoming EP Itin\u00e9raire. Mellow lofi, nostalgic melodies, and smooth...",
      "duration_seconds": 150,
      "favorite_count": 72,
      "genre": "Hip-Hop/Rap",
      "id": "J72oWO6",
      "is_downloadable": false,
      "is_streamable": true,
      "mood": "Melancholy",
      "musical_key": "D flat minor",
      "play_count": 7196,
      "price_usd": null,
      "release_date": "2026-10-09T14:26:27Z",
      "repost_count": 55,
      "tags": [
        "instrumental",
        "beats",
        "lofi",
        "jazz"
      ],
      "title": "Tohaj - Long Drive",
      "url": "https://audius.co/radiojuicy/tohaj-long-drive"
    },
    {
      "artist_handle": "CriticalMusic",
      "artist_id": "nQ2OW",
      "artist_name": "Critical Music",
      "artwork_url": "https://audius-creator-1.theblueprint.xyz/content/baeaaaiqseaqxrne2ee6v43xqj7ev3uwhpie3ye63q3ymibn5xatplj5jh53xy/480x480.jpg",
      "bpm": 84,
      "comment_count": 3,
      "created_at": "2026-10-09T09:26:13Z",
      "description": "Stream / Buy \u2192 https://found.ee/Binary_Vol30 \n\nCritical Presents: Binary Vol.30\n\nJapanese/Australian producer Fonts becomes the latest intern on Critical...",
      "duration_seconds": 292,
      "favorite_count": 38,
      "genre": "Drum & Bass",
      "id": "WNM7620",
      "is_downloadable": false,
      "is_streamable": true,
      "mood": "Sophisticated",
      "musical_key": "G minor",
      "play_count": 2166,
      "price_usd": null,
      "release_date": "2026-10-08T23:00:00Z",
      "repost_count": 36,
      "tags": [
        "liquiddnb",
        "dnb",
        "criticalmusic",
        "binary",
        "fonts"
      ],
      "title": "Fonts - Crystals",
      "url": "https://audius.co/CriticalMusic/fonts-crystals"
    }
  ],
  "updated_at": "2026-10-19T17:59:48Z",
  "url": "https://audius.co/Audius/playlist/hot-new-on-audius\ud83d\udd25"
}
```

### Get stream URL

Get a direct link to a track's MP3 audio, to download it or play it elsewhere. For a track that must be bought or unlocked it gives the preview clip.

**Inputs**

- Track (`track`, text, required): The track's Audius id (such as J72oWO6, from another Audius step) or its link on audius.co.

**Outputs**

- `is_preview` (true/false): True when the track must be bought or unlocked, so the link plays only its preview clip.
- `stream_url` (text): A direct link to the track's MP3 audio, ready to download or play.
- `track_id` (text): The track's Audius id.

**Example output**

```json
{
  "is_preview": false,
  "stream_url": "https://creatornode.audius.co/tracks/cidstream/baeaaaiqsebdrpgstke3pm2h74jclosselq2drgrfzs6lvqm46e2mnz6kjjhwo?signature=%7B%22data%22%3A%22%7B%5C%22cid%5C%22%3A%5C%22baeaaaiqsebdrpgstke3pm2h74jclosselq2drgrfzs6lvqm46e2mnz6kjjhwo%5C%22%2C%5C%22timestamp%5C%22%3A1792562818000%2C%5C%22trackId%5C%22%3A1257645695%2C%5C%22userId%5C%22%3A0%7D%22%2C%22signature%22%3A%220xf1f6c7dea196806386db7e41a66052adf49f59dd7ff0b1882aff687538ae97282a16ab0f44b088b73689c23f2e2504cf502563276c049a0885248889f41b264600%22%7D&skip_play_count=true",
  "track_id": "J72oWO6"
}
```

### Get track

Get one Audius track by its id or link: title, artist, genre, mood, tags, length, tempo, key, plays, favorites, reposts, comments, price and links.

**Inputs**

- Track (`track`, text, required): The track's Audius id (such as J72oWO6, from another Audius step) or its link on audius.co.

**Outputs**

- `artist_handle` (text): The artist's handle, as in audius.co/radiojuicy.
- `artist_id` (text): The Audius id of the artist who posted it.
- `artist_name` (text): The artist's display name.
- `artwork_url` (text): The cover art, 480 by 480 pixels, when it has one.
- `bpm` (number): Its tempo in beats per minute, when Audius knows it.
- `comment_count` (number): How many comments it has.
- `created_at` (text): When it was posted to Audius, ISO 8601 in UTC.
- `description` (text): The artist's description of the track.
- `duration_seconds` (number): How long the track is, in seconds.
- `favorite_count` (number): How many people favorited it.
- `genre` (text): The genre, e.g. 'Electronic' or 'Hip-Hop/Rap'.
- `id` (text): The track's Audius id, e.g. 'J72oWO6'. Use it in the other track steps.
- `is_downloadable` (true/false): True when the artist lets people download it.
- `is_streamable` (true/false): True when anyone can play the whole track; false when it must be bought or unlocked first.
- `mood` (text): The mood, e.g. 'Peaceful' or 'Energizing'.
- `musical_key` (text): Its key, e.g. 'A minor', when Audius knows it.
- `play_count` (number): How many times it was played.
- `price_usd` (number): The price in US dollars for a track sold on Audius, else empty.
- `release_date` (text): When it was released, ISO 8601 in UTC. Can be earlier than created_at for a back catalogue upload.
- `repost_count` (number): How many people reposted it.
- `tags` (list): The artist's tags for the track, e.g. ['lofi', 'jazz'].
- `title` (text): The track's title.
- `url` (text): The track's page on audius.co.

**Example output**

```json
{
  "artist_handle": "radiojuicy",
  "artist_id": "n3YPZ",
  "artist_name": "Radio Juicy",
  "artwork_url": "https://audius-discovery-3.altego.net/content/baeaaaiqseccucl5dyjluubaxfjy4w6pgolmjwncbelflkqnysisy5x44wv3fe/480x480.jpg",
  "bpm": 154,
  "comment_count": 8,
  "created_at": "2026-10-09T14:26:27Z",
  "description": "Radio Juicy is happy to present Tohaj\u2019s new single \u201cLong Drive\u201d, another step toward his upcoming EP Itin\u00e9raire. Mellow lofi, nostalgic melodies, and smooth...",
  "duration_seconds": 150,
  "favorite_count": 72,
  "genre": "Hip-Hop/Rap",
  "id": "J72oWO6",
  "is_downloadable": false,
  "is_streamable": true,
  "mood": "Melancholy",
  "musical_key": "D flat minor",
  "play_count": 7196,
  "price_usd": null,
  "release_date": "2026-10-09T14:26:27Z",
  "repost_count": 55,
  "tags": [
    "instrumental",
    "beats",
    "lofi",
    "jazz"
  ],
  "title": "Tohaj - Long Drive",
  "url": "https://audius.co/radiojuicy/tohaj-long-drive"
}
```

### Get user

Get an Audius artist's or listener's profile by handle, link or id: name, bio, location, followers, tracks, playlists, supporters and linked social accounts.

**Inputs**

- User (`user`, text, required): The user's handle as in audius.co/deadmau5 (with or without @), a link to their profile, or their Audius id from another step.

**Outputs**

- `album_count` (number): How many albums.
- `bio` (text): The profile's bio.
- `created_at` (text): When they joined Audius, ISO 8601 in UTC.
- `follower_count` (number): How many followers.
- `following_count` (number): How many users they follow.
- `handle` (text): The handle, as in audius.co/deadmau5.
- `id` (text): The user's Audius id, e.g. 'LKdlD'. Use it, or the handle, in the other user steps.
- `instagram_handle` (text): Their Instagram handle, when linked.
- `is_verified` (true/false): True for an account Audius has verified.
- `location` (text): Where they say they are.
- `name` (text): The display name.
- `playlist_count` (number): How many playlists.
- `profile_picture_url` (text): The profile picture, 480 by 480 pixels, when they have one.
- `repost_count` (number): How many reposts they made.
- `supporter_count` (number): How many fans have tipped them $AUDIO.
- `supporting_count` (number): How many artists they have tipped.
- `tiktok_handle` (text): Their TikTok handle, when linked.
- `track_count` (number): How many tracks they posted.
- `twitter_handle` (text): Their X (Twitter) handle, when linked.
- `url` (text): The profile on audius.co.
- `website` (text): The website on their profile.

**Example output**

```json
{
  "album_count": 0,
  "bio": "cube v3 on standby until further notice ;)",
  "created_at": "2019-09-24T04:10:30Z",
  "follower_count": 94985,
  "following_count": 3,
  "handle": "deadmau5",
  "id": "LKdlD",
  "instagram_handle": "deadmau5",
  "is_verified": true,
  "location": "Toronto, Canada",
  "name": "deadmau5",
  "playlist_count": 0,
  "profile_picture_url": "https://validator.stuffisup.com/content/QmWMKwECYqpJ9zXajwpEtmdGc4cntX9ktJMtUHGJfQNvs2/480x480.jpg",
  "repost_count": 1,
  "supporter_count": 69,
  "supporting_count": 0,
  "tiktok_handle": null,
  "track_count": 9,
  "twitter_handle": "deadmau5",
  "url": "https://audius.co/deadmau5",
  "website": null
}
```

### List followers

List the people who follow an Audius artist or listener.

**Inputs**

- User (`user`, text, required): The user's handle as in audius.co/deadmau5 (with or without @), a link to their profile, or their Audius id from another step.
- Number of results (`limit`, number): How many followers to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many followers came back.
- `handle` (text): The user's handle.
- `user_id` (text): The user's Audius id.
- `users` (list): The followers.

**Example output**

```json
{
  "count": 1,
  "handle": "deadmau5",
  "user_id": "LKdlD",
  "users": [
    {
      "album_count": 0,
      "bio": "The official Audius account!\n\nCreating a decentralized and open-source streaming music platform controlled by artists, fans, &...",
      "created_at": "2019-05-15T01:38:30Z",
      "follower_count": 1985456,
      "following_count": 2591,
      "handle": "Audius",
      "id": "eJ57D",
      "instagram_handle": "Audius",
      "is_verified": true,
      "location": "SF & LA",
      "name": "Audius",
      "playlist_count": 8,
      "profile_picture_url": "https://audius-content-7.figment.io/content/01KH6RG3Y0Y748QFHF3R9FP31V/480x480.jpg",
      "repost_count": 11338,
      "supporter_count": 263,
      "supporting_count": 15,
      "tiktok_handle": "audius",
      "track_count": 3,
      "twitter_handle": "Audius",
      "url": "https://audius.co/Audius",
      "website": "https://blog.audius.co"
    }
  ]
}
```

### List following

List the artists and listeners an Audius user follows.

**Inputs**

- User (`user`, text, required): The user's handle as in audius.co/deadmau5 (with or without @), a link to their profile, or their Audius id from another step.
- Number of results (`limit`, number): How many users to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many users they follow came back.
- `handle` (text): The user's handle.
- `user_id` (text): The user's Audius id.
- `users` (list): The users they follow.

**Example output**

```json
{
  "count": 1,
  "handle": "Audius",
  "user_id": "eJ57D",
  "users": [
    {
      "album_count": 0,
      "bio": null,
      "created_at": "2021-11-03T18:05:05Z",
      "follower_count": 513760,
      "following_count": 4,
      "handle": "Zedd",
      "id": "XlJby",
      "instagram_handle": null,
      "is_verified": true,
      "location": null,
      "name": "Zedd",
      "playlist_count": 0,
      "profile_picture_url": "https://audius-creator-15.theblueprint.xyz/content/Qmc29kZJ9hsKTaMwDzjWupkh8ALTDdr6T58bBwHd7zcz2b/480x480.jpg",
      "repost_count": 0,
      "supporter_count": 34,
      "supporting_count": 0,
      "tiktok_handle": null,
      "track_count": 1,
      "twitter_handle": "Zedd",
      "url": "https://audius.co/Zedd",
      "website": null
    }
  ]
}
```

### List latest tracks

List the tracks posted to Audius most recently, newest first, optionally only in one genre.

**Inputs**

- Genre (`genre`, text): Only include tracks in this genre. Leave empty for every genre. One of: `Electronic`, `Rock`, `Metal`, `Alternative`, `Hip-Hop/Rap`, `Experimental`, `Punk`, `Folk`, `Pop`, `Ambient`, and 41 more.
- Number of results (`limit`, number): How many tracks to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many tracks came back.
- `tracks` (list): The tracks, newest first.

**Example output**

```json
{
  "count": 1,
  "tracks": [
    {
      "artist_handle": "purrplecatmusic",
      "artist_id": "LjvkM",
      "artist_name": "Purrple Cat",
      "artwork_url": "https://cn4.mainnet.audiusindex.org/content/baeaaaiqsedcfuqcah2ckj7g4ffgpkqjse4reznxpzfo62aju2vn4tttnolnnu/480x480.jpg",
      "bpm": 110,
      "comment_count": 0,
      "created_at": "2026-10-21T00:56:01Z",
      "description": "From the album Up All Night by Purrple Cat (December 2018). Free to use with credit: Purrple Cat (CC BY 4.0). Please don't re-upload or release this music, or...",
      "duration_seconds": 139,
      "favorite_count": 11,
      "genre": "Lo-Fi",
      "id": "2V7kAQZ",
      "is_downloadable": true,
      "is_streamable": true,
      "mood": "Peaceful",
      "musical_key": "C major",
      "play_count": 4,
      "price_usd": null,
      "release_date": "2018-12-07T08:00:00Z",
      "repost_count": 13,
      "tags": [
        "lofi",
        "lofihiphop",
        "chill",
        "beats",
        "chillhop",
        "ambient",
        "instrumental",
        "purrplecat"
      ],
      "title": "I Thought We'd Be Friends Forever",
      "url": "https://audius.co/purrplecatmusic/i-thought-wed-be-friends-forever"
    }
  ]
}
```

### List top supporters

List an Audius artist's top supporters: the fans who have tipped them the most $AUDIO, biggest first, with how much.

**Inputs**

- User (`user`, text, required): The user's handle as in audius.co/deadmau5 (with or without @), a link to their profile, or their Audius id from another step.
- Number of results (`limit`, number): How many supporters to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many supporters came back.
- `handle` (text): The user's handle.
- `supporters` (list): The supporters, biggest first.
- `user_id` (text): The user's Audius id.

**Example output**

```json
{
  "count": 2,
  "handle": "deadmau5",
  "supporters": [
    {
      "amount_audio": 243.0,
      "follower_count": 284,
      "handle": "Bo_Scott",
      "is_verified": true,
      "name": "Bo Scott",
      "rank": 1,
      "url": "https://audius.co/Bo_Scott",
      "user_id": "ndwly"
    },
    {
      "amount_audio": 216.0,
      "follower_count": 395,
      "handle": "Mr.FLEN",
      "is_verified": false,
      "name": "Mr.FLEN",
      "rank": 2,
      "url": "https://audius.co/Mr.FLEN",
      "user_id": "OW828rV"
    }
  ],
  "user_id": "LKdlD"
}
```

### List track comments

List the comments on an Audius track, with who wrote each, the moment in the track it was left at and how many liked it.

**Inputs**

- Track (`track`, text, required): The track's Audius id (such as J72oWO6, from another Audius step) or its link on audius.co.
- Order (`sort`, text): How to order the comments. Defaults to top comments first. One of: `top` (Top comments first), `newest` (Newest first), `timestamp` (By moment in the track). Default: `top`.
- Number of results (`limit`, number): How many comments to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `comments` (list): The comments, in the order asked for.
- `count` (number): How many comments came back.
- `track_id` (text): The track's Audius id.

**Example output**

```json
{
  "comments": [
    {
      "created_at": "2026-10-18T18:26:50Z",
      "id": "Q752Nrw",
      "is_edited": false,
      "like_count": 0,
      "liked_by_artist": false,
      "message": "this is smooth bro",
      "reply_count": 0,
      "track_timestamp_seconds": 45,
      "user_handle": "bleuiloveyou",
      "user_id": "DBXOQ",
      "user_name": "sorrydeath"
    },
    {
      "created_at": "2026-10-15T19:56:36Z",
      "id": "qPvYpY",
      "is_edited": false,
      "like_count": 0,
      "liked_by_artist": false,
      "message": "love everything about this",
      "reply_count": 0,
      "track_timestamp_seconds": 67,
      "user_handle": "SonicTexturez",
      "user_id": "nQAE1",
      "user_name": "SonicTexturez"
    }
  ],
  "count": 2,
  "track_id": "J72oWO6"
}
```

### List trending playlists

List Audius's trending playlists or albums this week, month, year or of all time.

**Inputs**

- Trending over (`time_range`, text): The period whose plays, favorites and reposts count. Defaults to this week. One of: `week` (This week), `month` (This month), `year` (This year), `allTime` (All time). Default: `week`.
- Playlists or albums (`collection`, text): Whether to list playlists or albums. Defaults to playlists. One of: `playlist` (Playlists), `album` (Albums). Default: `playlist`.
- Number of results (`limit`, number): How many playlists to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many playlists or albums came back.
- `playlists` (list): The playlists or albums, highest on the chart first.

**Example output**

```json
{
  "count": 1,
  "playlists": [
    {
      "artwork_url": "https://v.monophonic.digital/content/baeaaaiqsebbsixdhk6scrhij224uyq72yn4p2e3jbdz5cf5eezvdmwhw64yj4/480x480.jpg",
      "created_at": "2026-10-16T12:51:36Z",
      "description": null,
      "favorite_count": 8,
      "id": "3az1B",
      "is_album": false,
      "name": "Silentium",
      "owner_handle": "rene_obe",
      "owner_id": "aAm31",
      "owner_name": "Ren\u00e9 Obe",
      "repost_count": 8,
      "total_play_count": 518407,
      "track_count": 65,
      "updated_at": "2026-10-18T12:05:09Z",
      "url": "https://audius.co/rene_obe/playlist/silentium"
    }
  ]
}
```

### List trending tracks

List Audius's Trending chart: the tracks with the most plays, favorites and reposts this week, month, year or of all time, optionally in one genre.

**Inputs**

- Genre (`genre`, text): Only include tracks in this genre. Leave empty for every genre. One of: `Electronic`, `Rock`, `Metal`, `Alternative`, `Hip-Hop/Rap`, `Experimental`, `Punk`, `Folk`, `Pop`, `Ambient`, and 41 more.
- Trending over (`time_range`, text): The period whose plays, favorites and reposts count. Defaults to this week. One of: `week` (This week), `month` (This month), `year` (This year), `allTime` (All time). Default: `week`.
- Number of results (`limit`, number): How many tracks to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many tracks came back.
- `tracks` (list): The tracks, highest on the chart first.

**Example output**

```json
{
  "count": 1,
  "tracks": [
    {
      "artist_handle": "vansnydermusic",
      "artist_id": "k259kWP",
      "artist_name": "Van Snyder",
      "artwork_url": "https://audius-05.staked.cloud/content/baeaaaiqsec4us4k34ga2bezfpdbxxd5xc233l6hlqzcbo6mqqzxvlop7nbkpu/480x480.jpg",
      "bpm": 120,
      "comment_count": 19,
      "created_at": "2026-09-21T18:03:02Z",
      "description": "Tracklist: https://1001.tl/14yc4sd9 \n\n01. Titus1 & Meredith Miller - River of Lies [Interplay Unity]\n02. tyDi, Van Snyder & TOROK - Witch Doctor (Michael Grald...",
      "duration_seconds": 3573,
      "favorite_count": 88,
      "genre": "Electronic",
      "id": "NQwXON0",
      "is_downloadable": false,
      "is_streamable": true,
      "mood": "Fiery",
      "musical_key": "A minor",
      "play_count": 4397,
      "price_usd": null,
      "release_date": "2026-09-21T18:03:02Z",
      "repost_count": 70,
      "tags": [
        "Edm",
        "Mainstage",
        "Electro",
        "Trance",
        "Dance",
        "Pop",
        "Festival",
        "Electronic",
        "Bigroom",
        "Rave"
      ],
      "title": "Van Snyder - Rave! Code Radio 025",
      "url": "https://audius.co/vansnydermusic/van-snyder-rave-code-radio-025"
    }
  ]
}
```

### List underground trending tracks

List Audius's Underground Trending chart: tracks rising this week from artists with smaller followings.

**Inputs**

- Number of results (`limit`, number): How many tracks to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many tracks came back.
- `tracks` (list): The tracks, highest on the chart first.

**Example output**

```json
{
  "count": 1,
  "tracks": [
    {
      "artist_handle": "narshwhal",
      "artist_id": "6aPA9",
      "artist_name": "/\\/arshwhal",
      "artwork_url": "https://val016.open-audio-validator.com/content/baeaaaiqseduxch4r5jn6jri3ey5tsndpkdcaxzdbtrn5gwatiyp37xl7v5t2k/480x480.jpg",
      "bpm": 125,
      "comment_count": 3,
      "created_at": "2026-10-17T22:50:37Z",
      "description": "A track that was once released on a label of mine has now finally been pushed back out there for all to enjoy once again <3 Thank you for all the support",
      "duration_seconds": 153,
      "favorite_count": 22,
      "genre": "House",
      "id": "mWA7Kdr",
      "is_downloadable": false,
      "is_streamable": true,
      "mood": "Energizing",
      "musical_key": "B minor",
      "play_count": 82,
      "price_usd": null,
      "release_date": "2026-10-17T22:50:37Z",
      "repost_count": 23,
      "tags": [
        "house",
        "upbeat",
        "happy",
        "narsh"
      ],
      "title": "Last Adventure",
      "url": "https://audius.co/narshwhal/last-adventure"
    }
  ]
}
```

### List user favorites

List the tracks an Audius user has favorited, most recently favorited first.

**Inputs**

- User (`user`, text, required): The user's handle as in audius.co/deadmau5 (with or without @), a link to their profile, or their Audius id from another step.
- Number of results (`limit`, number): How many tracks to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many favorite tracks came back.
- `favorites` (list): The favorite tracks, most recently favorited first.
- `handle` (text): The user's handle.
- `user_id` (text): The user's Audius id.

**Example output**

```json
{
  "count": 1,
  "favorites": [
    {
      "artist_handle": "dannic",
      "artist_id": "07RWGVm",
      "artist_name": "Dannic",
      "artwork_url": "https://audius-creator-11.theblueprint.xyz/content/baeaaaiqsecd464n7qxtqqo67upgngf2fcajvoo34d77qqipyxnu2vpqazrwom/480x480.jpg",
      "bpm": 128,
      "comment_count": 14,
      "created_at": "2026-09-02T19:29:16Z",
      "description": "Fonk Monthly Mix Episode 032\n\nEpisode 032 of the Fonk Monthly Mix delivers a relentless journey through big room and progressive house, anchored by Dannic...",
      "duration_seconds": 3673,
      "favorite_count": 73,
      "favorited_at": "2026-09-04T23:54:26Z",
      "genre": "Electronic",
      "id": "dlk8KgJ",
      "is_downloadable": false,
      "is_streamable": true,
      "mood": "Fiery",
      "musical_key": "C minor",
      "play_count": 1924,
      "price_usd": null,
      "release_date": "2026-09-02T19:29:16Z",
      "repost_count": 54,
      "tags": [],
      "title": "Dannic presents Fonk Monthly Mix 032 (August 2026)",
      "url": "https://audius.co/dannic/dannic-presents-fonk-monthly-mix-032-august-2026"
    }
  ],
  "handle": "Audius",
  "user_id": "eJ57D"
}
```

### List user reposts

List the tracks, playlists and albums an Audius user has reposted, most recent first.

**Inputs**

- User (`user`, text, required): The user's handle as in audius.co/deadmau5 (with or without @), a link to their profile, or their Audius id from another step.
- Number of results (`limit`, number): How many reposts to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many reposts came back.
- `handle` (text): The user's handle.
- `reposts` (list): The reposts, most recent first.
- `user_id` (text): The user's Audius id.

**Example output**

```json
{
  "count": 1,
  "handle": "Audius",
  "reposts": [
    {
      "artist_handle": "shizzlomusic",
      "artist_id": "nVVky",
      "artist_name": "Shizz Lo",
      "id": "pVEvj8z",
      "item_type": "track",
      "reposted_at": "2026-10-21T00:31:32Z",
      "title": "Quavo & Takeoff - Hotel Lobby (Shizz Lo Flip)",
      "url": "https://audius.co/shizzlomusic/quavo-takeoff-hotel-lobby-shizz-lo-flip"
    }
  ],
  "user_id": "eJ57D"
}
```

### List user tracks

List the tracks an artist has posted on Audius, newest release, oldest release, most played or by title first. The track the artist pinned to their profile comes first.

**Inputs**

- User (`user`, text, required): The user's handle as in audius.co/deadmau5 (with or without @), a link to their profile, or their Audius id from another step.
- Order (`order`, text): How to order the tracks. Defaults to the newest release first. One of: `newest` (Newest release first), `oldest` (Oldest release first), `most_played` (Most played first), `title` (By title, A to Z). Default: `newest`.
- Number of results (`limit`, number): How many tracks to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many tracks came back.
- `handle` (text): The user's handle.
- `tracks` (list): The tracks, in the order asked for.
- `user_id` (text): The user's Audius id.

**Example output**

```json
{
  "count": 1,
  "handle": "deadmau5",
  "tracks": [
    {
      "artist_handle": "deadmau5",
      "artist_id": "LKdlD",
      "artist_name": "deadmau5",
      "artwork_url": "https://audius-creator-12.theblueprint.xyz/content/QmQcmc5CR2z2WkzirJmWvp8ZJp1ztVbvaX6Ak5mk9K3ojQ/480x480.jpg",
      "bpm": 166.7,
      "comment_count": 9,
      "created_at": "2021-05-11T18:26:10Z",
      "description": "stream / dl \"Nextra\" - https://ffm.to/nextra\n\nupload your remix 'n' tag the original upload / share on socials :D",
      "duration_seconds": 61,
      "favorite_count": 1747,
      "genre": "Electronic",
      "id": "7YmNr",
      "is_downloadable": true,
      "is_streamable": true,
      "mood": "Cool",
      "musical_key": "A flat minor",
      "play_count": 106969,
      "price_usd": null,
      "release_date": "2021-05-11T15:05:00Z",
      "repost_count": 713,
      "tags": [
        "deadmau5",
        "hau5trap",
        "nextra",
        "remix",
        "dance",
        "house"
      ],
      "title": "deadmau5 - Nextra (Stem Drop)",
      "url": "https://audius.co/deadmau5/deadmau5-nextra-stem-drop-402369"
    }
  ],
  "user_id": "LKdlD"
}
```

### List who favorited a track

List the people who favorited an Audius track, with their profiles.

**Inputs**

- Track (`track`, text, required): The track's Audius id (such as J72oWO6, from another Audius step) or its link on audius.co.
- Number of results (`limit`, number): How many people to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many people who favorited it came back.
- `track_id` (text): The track's Audius id.
- `users` (list): The people who favorited it.

**Example output**

```json
{
  "count": 1,
  "track_id": "J72oWO6",
  "users": [
    {
      "album_count": 6,
      "bio": "One love\ud83d\ude00\u270c\ufe0f\ud83d\udc4a\ud83d\ude0e\nEIME, Konstantin Mikhailov\nIndie  Underground Artist\nAmbiental Hip Hop\nInstrumental Boom Bap\nDisco...",
      "created_at": "2020-05-01T06:48:05Z",
      "follower_count": 4603,
      "following_count": 1024,
      "handle": "EIME",
      "id": "eJmB7",
      "instagram_handle": "therealoldschoolhiphop",
      "is_verified": false,
      "location": "Saint Petersburg, Russia",
      "name": "EIME",
      "playlist_count": 2,
      "profile_picture_url": "https://v.monophonic.digital/content/Qmf9JbnkGLMSz6Ym4PXnT91Xs9DxztWHYWQi1wWo98FVS9/480x480.jpg",
      "repost_count": 92826,
      "supporter_count": 64,
      "supporting_count": 6,
      "tiktok_handle": null,
      "track_count": 80,
      "twitter_handle": null,
      "url": "https://audius.co/EIME",
      "website": "https://wikitia.com/wiki/EIME_(musician)"
    }
  ]
}
```

### List who reposted a track

List the people who reposted an Audius track, with their profiles.

**Inputs**

- Track (`track`, text, required): The track's Audius id (such as J72oWO6, from another Audius step) or its link on audius.co.
- Number of results (`limit`, number): How many people to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many people who reposted it came back.
- `track_id` (text): The track's Audius id.
- `users` (list): The people who reposted it.

**Example output**

```json
{
  "count": 1,
  "track_id": "J72oWO6",
  "users": [
    {
      "album_count": 0,
      "bio": "The official Audius account!\n\nCreating a decentralized and open-source streaming music platform controlled by artists, fans, &...",
      "created_at": "2019-05-15T01:38:30Z",
      "follower_count": 1985456,
      "following_count": 2591,
      "handle": "Audius",
      "id": "eJ57D",
      "instagram_handle": "Audius",
      "is_verified": true,
      "location": "SF & LA",
      "name": "Audius",
      "playlist_count": 8,
      "profile_picture_url": "https://val018.open-audio-validator.com/content/01KH6RG3Y0Y748QFHF3R9FP31V/480x480.jpg",
      "repost_count": 11338,
      "supporter_count": 263,
      "supporting_count": 15,
      "tiktok_handle": "audius",
      "track_count": 3,
      "twitter_handle": "Audius",
      "url": "https://audius.co/Audius",
      "website": "https://blog.audius.co"
    }
  ]
}
```

### Search playlists

Search Audius playlists by name, optionally only some genres or moods, best match, most popular or newest first.

**Inputs**

- Search for (`query`, text): Words to look for in playlist names. Leave empty to search by the filters alone.
- Genres (`genres`, list): Only include playlists in any of these genres. One or more of: `Electronic`, `Rock`, `Metal`, `Alternative`, `Hip-Hop/Rap`, `Experimental`, `Punk`, `Folk`, `Pop`, `Ambient`, and 41 more.
- Moods (`moods`, list): Only include playlists with any of these moods. One or more of: `Peaceful`, `Romantic`, `Sentimental`, `Tender`, `Easygoing`, `Yearning`, `Sophisticated`, `Sensual`, `Cool`, `Gritty`, and 13 more.
- Order (`sort`, text): How to order the results. Defaults to the best match first. One of: `relevant` (Best match), `popular` (Most popular), `recent` (Newest). Default: `relevant`.
- Number of results (`limit`, number): How many playlists to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many playlists came back.
- `playlists` (list): The playlists, in the order asked for.

**Example output**

```json
{
  "count": 1,
  "playlists": [
    {
      "artwork_url": "https://audius-content-2.figment.io/content/QmdhNNYqk4K1Pnb3gCFpakNaaYcFiz5owecDSwRG5SokNZ/480x480.jpg",
      "created_at": "2020-10-25T15:41:20Z",
      "description": "lofi hip hop tunes to study to, selected by Blake Tree",
      "favorite_count": 766,
      "id": "ebd1O",
      "is_album": false,
      "name": "lofi road trip - chill lofi, hiphop & jazz pop",
      "owner_handle": "blaketree",
      "owner_id": "LMQaZ",
      "owner_name": "Blake Tree",
      "repost_count": 404,
      "total_play_count": 1707653,
      "track_count": 112,
      "updated_at": "2022-01-07T14:16:00Z",
      "url": "https://audius.co/blaketree/playlist/lofi-road-trip-chill-lofi-hiphop-jazz-pop-13491"
    }
  ]
}
```

### Search tracks

Search Audius tracks by words in the title, artist or tags, optionally only some genres, moods or tempos, best match, most popular or newest first.

**Inputs**

- Search for (`query`, text): Words to look for in track titles, artists and tags. Leave empty to search by the filters alone.
- Genres (`genres`, list): Only include tracks in any of these genres. One or more of: `Electronic`, `Rock`, `Metal`, `Alternative`, `Hip-Hop/Rap`, `Experimental`, `Punk`, `Folk`, `Pop`, `Ambient`, and 41 more.
- Moods (`moods`, list): Only include tracks with any of these moods. One or more of: `Peaceful`, `Romantic`, `Sentimental`, `Tender`, `Easygoing`, `Yearning`, `Sophisticated`, `Sensual`, `Cool`, `Gritty`, and 13 more.
- Order (`sort`, text): How to order the results. Defaults to the best match first. One of: `relevant` (Best match), `popular` (Most popular), `recent` (Newest). Default: `relevant`.
- Slowest tempo (BPM) (`min_bpm`, number): Only include tracks at this many beats per minute or more. From 1 to 300.
- Fastest tempo (BPM) (`max_bpm`, number): Only include tracks at this many beats per minute or fewer. From 1 to 300.
- Number of results (`limit`, number): How many tracks to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many tracks came back.
- `tracks` (list): The tracks, in the order asked for.

**Example output**

```json
{
  "count": 1,
  "tracks": [
    {
      "artist_handle": "beaumonthenry",
      "artist_id": "nqgRa",
      "artist_name": "Beaumont",
      "artwork_url": "https://val001.open-audio-validator.com/content/QmWQDyY2TNy8tddU5Wscc61RM9iTXJRajpw1B1RyGgcEby/480x480.jpg",
      "bpm": 90,
      "comment_count": 4,
      "created_at": "2021-05-06T17:32:25Z",
      "description": null,
      "duration_seconds": 128,
      "favorite_count": 21,
      "genre": "Electronic",
      "id": "XOqAJ",
      "is_downloadable": false,
      "is_streamable": true,
      "mood": "Peaceful",
      "musical_key": "A minor",
      "play_count": 32155,
      "price_usd": null,
      "release_date": "2021-05-06T14:03:00Z",
      "repost_count": 11,
      "tags": [
        "lofi",
        "instrumental",
        "lofihiphop",
        "chill",
        "beats",
        "study",
        "chillhop",
        "rhodes",
        "calm"
      ],
      "title": "night sky",
      "url": "https://audius.co/beaumonthenry/night-sky-396168"
    }
  ]
}
```

### Search users

Search Audius artists and listeners by name or handle, optionally only verified accounts or artists of some genres.

**Inputs**

- Search for (`query`, text): Words to look for in names and handles. Leave empty to search by the filters alone.
- Genres (`genres`, list): Only include artists in any of these genres. One or more of: `Electronic`, `Rock`, `Metal`, `Alternative`, `Hip-Hop/Rap`, `Experimental`, `Punk`, `Folk`, `Pop`, `Ambient`, and 41 more.
- Verified accounts only (`verified_only`, true/false): Only include accounts Audius has verified. Default: `false`.
- Order (`sort`, text): How to order the results. Defaults to the best match first. One of: `relevant` (Best match), `popular` (Most popular), `recent` (Newest). Default: `relevant`.
- Number of results (`limit`, number): How many users to return, 1 to 100. Defaults to 20. From 1 to 100.
- Skip (`offset`, number): How many results to skip, to read the next page: with 20 results a page, 20 gives the second page. Defaults to 0. At least 0.

**Outputs**

- `count` (number): How many users came back.
- `users` (list): The users, in the order asked for.

**Example output**

```json
{
  "count": 1,
  "users": [
    {
      "album_count": 0,
      "bio": "cube v3 on standby until further notice ;)",
      "created_at": "2019-09-24T04:10:30Z",
      "follower_count": 94985,
      "following_count": 3,
      "handle": "deadmau5",
      "id": "LKdlD",
      "instagram_handle": "deadmau5",
      "is_verified": true,
      "location": "Toronto, Canada",
      "name": "deadmau5",
      "playlist_count": 0,
      "profile_picture_url": "https://v.monophonic.digital/content/QmWMKwECYqpJ9zXajwpEtmdGc4cntX9ktJMtUHGJfQNvs2/480x480.jpg",
      "repost_count": 1,
      "supporter_count": 69,
      "supporting_count": 0,
      "tiktok_handle": null,
      "track_count": 9,
      "twitter_handle": "deadmau5",
      "url": "https://audius.co/deadmau5",
      "website": null
    }
  ]
}
```
