Audius MCP Server
by glassBead-tc
Audius API Documentation
Audius V1 API
users
This folder doesn't have a description.
GET
Get User
https://discoveryprovider.audius.co/v1/users/:id
Gets a single user by their user ID
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
}
GET
Get User by Handle
https://discoveryprovider.audius.co/v1/users/handle/:handle?user_id=<string>
Gets a single user by their handle
Query Params
user_id
<string>
The user ID of the user making the request
Path Variables
handle
<string>
(Required) A User handle
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/handle/:handle?user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
}
GET
Get User by Wallet
https://discoveryprovider.audius.co/v1/users/id?associated_wallet=<string>
Gets a User ID from an associated wallet address
Query Params
associated_wallet
<string>
(Required) Wallet address
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/id?associated_wallet=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
json
{
"data": {
"user_id": "<string>"
}
}
GET
Get Bulk Users
https://discoveryprovider.audius.co/v1/users?user_id=<string>&id=<string>&id=<string>
Gets a list of users by ID
Query Params
user_id
<string>
The user ID of the user making the request
id
<string>
The ID of the user(s)
id
<string>
The ID of the user(s)
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users?user_id=%3Cstring%3E&id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
]
}
GET
Search Users
https://discoveryprovider.audius.co/v1/users/search?query=<string>&genre=<string>&genre=<string>&sort_method=popular&is_verified=<string>
Search for users that match the given query
Query Params
query
<string>
The search query
genre
<string>
The genres to filter by
genre
<string>
The genres to filter by
sort_method
popular
The sort method
is_verified
<string>
Only include verified users in the user results
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/search?query=%3Cstring%3E&genre=%3Cstring%3E&sort_method=popular&is_verified=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
]
}
GET
Get Tracks by User
https://discoveryprovider.audius.co/v1/users/:id/tracks?offset=<integer>&limit=<integer>&user_id=<string>&sort=date&query=<string>&sort_method=plays&sort_direction=asc&filter_tracks=all
Gets the tracks created by a user using their user ID
Request Headers
Encoded-Data-Message
<string>
The data that was signed by the user for signature recovery
Encoded-Data-Signature
<string>
The signature of data, used for signature recovery
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
sort
date
[Deprecated] Field to sort by
query
<string>
The filter query
sort_method
plays
The sort method
sort_direction
asc
The sort direction
filter_tracks
all
Filter by unlisted or public tracks
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/tracks?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E&sort=date&query=%3Cstring%3E&sort_method=plays&sort_direction=asc&filter_tracks=all' \
--header 'Encoded-Data-Message: <string>' \
--header 'Encoded-Data-Signature: <string>' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
},
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
]
}
GET
Get Favorites
https://discoveryprovider.audius.co/v1/users/:id/favorites
Gets a user's favorite tracks
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/favorites' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"created_at": "<string>",
"favorite_item_id": "<string>",
"favorite_type": "<string>",
"user_id": "<string>"
},
{
"created_at": "<string>",
"favorite_item_id": "<string>",
"favorite_type": "<string>",
"user_id": "<string>"
}
]
}
GET
Get Reposts
https://discoveryprovider.audius.co/v1/users/:id/reposts?offset=<integer>&limit=<integer>&user_id=<string>
Gets the given user's reposts
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/reposts?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"class": "<string>",
"item": {},
"item_type": "track",
"timestamp": "<string>"
},
{
"class": "<string>",
"item": {},
"item_type": "playlist",
"timestamp": "<string>"
}
]
}
GET
Get Followers
https://discoveryprovider.audius.co/v1/users/:id/followers?offset=<integer>&limit=<integer>&user_id=<string>
All users that follow the provided user
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/followers?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
]
}
GET
Get Following
https://discoveryprovider.audius.co/v1/users/:id/following?offset=<integer>&limit=<integer>&user_id=<string>
All users that the provided user follows
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/following?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
]
}
GET
Get Subscribers
https://discoveryprovider.audius.co/v1/users/:id/subscribers?offset=<integer>&limit=<integer>&user_id=<string>
All users that subscribe to the provided user
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/subscribers?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
]
}
GET
Get Supporters
https://discoveryprovider.audius.co/v1/users/:id/supporters?offset=<integer>&limit=<integer>
Gets the supporters of the given user
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/supporters?offset=%3Cinteger%3E&limit=%3Cinteger%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"amount": "<string>",
"rank": "<integer>",
"sender": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
},
{
"amount": "<string>",
"rank": "<integer>",
"sender": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
}
]
}
GET
Get Most Used Tags
https://discoveryprovider.audius.co/v1/users/:id/tags?limit=<integer>&user_id=<string>
Gets the most used track tags by a user.
Query Params
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/tags?limit=%3Cinteger%3E&user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
json
{
"data": [
"<string>",
"<string>"
]
}
GET
Get AI Tracks by Handle
https://discoveryprovider.audius.co/v1/users/handle/:handle/tracks/ai_attributed?offset=<integer>&limit=<integer>&user_id=<string>&sort=date&query=<string>&sort_method=plays&sort_direction=asc&filter_tracks=all
Gets the AI generated tracks attributed to a user using the user's handle
Request Headers
Encoded-Data-Message
<string>
The data that was signed by the user for signature recovery
Encoded-Data-Signature
<string>
The signature of data, used for signature recovery
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
sort
date
[Deprecated] Field to sort by
query
<string>
The filter query
sort_method
plays
The sort method
sort_direction
asc
The sort direction
filter_tracks
all
Filter by unlisted or public tracks
Path Variables
handle
<string>
(Required) A User handle
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/handle/:handle/tracks/ai_attributed?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E&sort=date&query=%3Cstring%3E&sort_method=plays&sort_direction=asc&filter_tracks=all' \
--header 'Encoded-Data-Message: <string>' \
--header 'Encoded-Data-Signature: <string>' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
},
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
]
}
GET
Get Related Users
https://discoveryprovider.audius.co/v1/users/:id/related?offset=<integer>&limit=<integer>&user_id=<string>
Gets a list of users that might be of interest to followers of this user.
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/related?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
]
}
GET
Verify OAuth Token
https://discoveryprovider.audius.co/v1/users/verify_token?token=<string>
Verify if the given jwt ID token was signed by the subject (user) in the payload
Query Params
token
<string>
(Required) JWT to verify
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/verify_token?token=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": {
"email": "<string>",
"handle": "<string>",
"iat": "<string>",
"name": "<string>",
"sub": "<string>",
"userId": "<string>",
"verified": "<boolean>",
"profilePicture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
}
}
}
GET
Get Authorized Apps
https://discoveryprovider.audius.co/v1/users/:id/authorized_apps
Get the apps that user has authorized to write to their account
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/authorized_apps' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"address": "<string>",
"grant_created_at": "<string>",
"grant_updated_at": "<string>",
"grantor_user_id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>"
},
{
"address": "<string>",
"grant_created_at": "<string>",
"grant_updated_at": "<string>",
"grantor_user_id": "<string>",
"name": "<string>",
"description": "<string>",
"image_url": "<string>"
}
]
}
GET
Get Connected Wallets
https://discoveryprovider.audius.co/v1/users/:id/connected_wallets
Get the User's ERC and SPL connected wallets
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/connected_wallets' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": {
"erc_wallets": [
"<string>",
"<string>"
],
"spl_wallets": [
"<string>",
"<string>"
]
}
}
GET
Get Purchasers
https://discoveryprovider.audius.co/v1/users/:id/purchasers?offset=<integer>&limit=<integer>&user_id=<string>&content_type=<string>&content_id=<string>
Gets the list of unique users who have purchased content by the given user
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
content_type
<string>
Type of content to filter by (track or album)
content_id
<string>
Filters for users who have purchased the given track or album ID
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/purchasers?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E&content_type=%3Cstring%3E&content_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
]
}
GET
Get Remixers
https://discoveryprovider.audius.co/v1/users/:id/remixers?offset=<integer>&limit=<integer>&user_id=<string>&track_id=<string>
Gets the list of unique users who have remixed tracks by the given user, or a specific track by that user if provided
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
track_id
<string>
Filters for remixers who have remixed the given track ID
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/remixers?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E&track_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
{
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
]
}
GET
Get Supported Users
https://discoveryprovider.audius.co/v1/users/:id/supporting?offset=<integer>&limit=<integer>
Gets the users that the given user supports
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/supporting?offset=%3Cinteger%3E&limit=%3Cinteger%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"amount": "<string>",
"rank": "<integer>",
"receiver": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
},
{
"amount": "<string>",
"rank": "<integer>",
"receiver": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
}
]
}
GET
Get User Tracks Remixed
https://discoveryprovider.audius.co/v1/users/:id/tracks/remixed?offset=<integer>&limit=<integer>&user_id=<string>
Gets tracks owned by the user which have been remixed by another track
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/tracks/remixed?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
},
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
]
}
tracks
This folder doesn't have a description.
GET
Get Track
https://discoveryprovider.audius.co/v1/tracks/:track_id
Gets a track by ID
Path Variables
track_id
<string>
(Required) A Track ID
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/:track_id' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": {
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
}
GET
Get Bulk Tracks
https://discoveryprovider.audius.co/v1/tracks?permalink=<string>&permalink=<string>&id=<string>&id=<string>
Gets a list of tracks using their IDs or permalinks
Query Params
permalink
<string>
The permalink of the track(s)
permalink
<string>
The permalink of the track(s)
id
<string>
The ID of the track(s)
id
<string>
The ID of the track(s)
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks?permalink=%3Cstring%3E&id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
},
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
]
}
GET
Search Tracks
https://discoveryprovider.audius.co/v1/tracks/search?query=<string>&genre=<string>&genre=<string>&sort_method=popular&mood=<string>&mood=<string>&only_downloadable=false&includePurchaseable=<string>&is_purchaseable=<string>&has_downloads=<string>&key=<string>&key=<string>&bpm_min=<string>&bpm_max=<string>
Search for a track or tracks
Query Params
query
<string>
The search query
genre
<string>
The genres to filter by
genre
<string>
The genres to filter by
sort_method
popular
The sort method
mood
<string>
The moods to filter by
mood
<string>
The moods to filter by
only_downloadable
false
Return only downloadable tracks
includePurchaseable
<string>
Whether or not to include purchaseable content
is_purchaseable
<string>
Only include purchaseable tracks and albums in the track and album results
has_downloads
<string>
Only include tracks that have downloads in the track results
key
<string>
Only include tracks that match the musical key
key
<string>
Only include tracks that match the musical key
bpm_min
<string>
Only include tracks that have a bpm greater than or equal to
bpm_max
<string>
Only include tracks that have a bpm less than or equal to
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/search?query=%3Cstring%3E&genre=%3Cstring%3E&sort_method=popular&mood=%3Cstring%3E&only_downloadable=false&includePurchaseable=%3Cstring%3E&is_purchaseable=%3Cstring%3E&has_downloads=%3Cstring%3E&key=%3Cstring%3E&bpm_min=%3Cstring%3E&bpm_max=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
},
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
]
}
GET
Get Trending Tracks
https://discoveryprovider.audius.co/v1/tracks/trending?genre=<string>&time=week
Gets the top 100 trending (most popular) tracks on Audius
Query Params
genre
<string>
Filter trending to a specified genre
time
week
Calculate trending over a specified time range
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/trending?genre=%3Cstring%3E&time=week' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
},
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
]
}
GET
Get Underground Trending Tracks
https://discoveryprovider.audius.co/v1/tracks/trending/underground?offset=<integer>&limit=<integer>
Gets the top 100 trending underground tracks on Audius
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/trending/underground?offset=%3Cinteger%3E&limit=%3Cinteger%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
},
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
]
}
GET
Get Track Access Info
https://discoveryprovider.audius.co/v1/tracks/:track_id/access-info?user_id=<string>&include_network_cut=<boolean>
Gets the information necessary to access the track and what access the given user has.
Query Params
user_id
<string>
The user ID of the user making the request
include_network_cut
<boolean>
Whether to include the staking system as a recipient
Path Variables
track_id
<string>
(Required) A Track ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/:track_id/access-info?user_id=%3Cstring%3E&include_network_cut=%3Cboolean%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": {
"blocknumber": "<integer>",
"user_id": "<string>",
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"is_stream_gated": "<boolean>",
"stream_conditions": {
"tip_user_id": "<integer>"
},
"is_download_gated": "<boolean>",
"download_conditions": {
"tip_user_id": "<integer>"
}
}
}
GET
Stream Track
https://discoveryprovider.audius.co/v1/tracks/:track_id/stream?user_id=<string>&preview=false&user_signature=<string>&user_data=<string>&nft_access_signature=<string>&skip_play_count=false&api_key=<string>&skip_check=<boolean>&no_redirect=<boolean>
Stream an mp3 track
This endpoint accepts the Range header for streaming.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Range_requests
Query Params
user_id
<string>
The user ID of the user making the request
preview
false
Optional - true if streaming track preview
user_signature
<string>
Optional - signature from the requesting user's wallet.
This is needed to authenticate the user and verify access in case the track is gated.
user_data
<string>
Optional - data which was used to generate the optional signature argument.
nft_access_signature
<string>
Optional - gated content signature for this track which was previously generated by a registered DN.
We perform checks on it and pass it through to CN.
skip_play_count
false
Optional - boolean that disables tracking of play counts.
api_key
<string>
Optional - API key for third party apps. This is required for tracks that only allow specific API keys.
skip_check
<boolean>
Optional - POC to skip node 'double dip' health check
no_redirect
<boolean>
Optional - If true will not return a 302 and instead will return the stream url in JSON
Path Variables
track_id
<string>
(Required) A Track ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/:track_id/stream?user_id=%3Cstring%3E&preview=false&user_signature=%3Cstring%3E&user_data=%3Cstring%3E&nft_access_signature=%3Cstring%3E&skip_play_count=false&api_key=%3Cstring%3E&skip_check=%3Cboolean%3E&no_redirect=%3Cboolean%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
json
{
"data": "<string>"
}
GET
Download Track
https://discoveryprovider.audius.co/v1/tracks/:track_id/download?user_id=<string>&user_signature=<string>&user_data=<string>&nft_access_signature=<string>&original=false&filename=<string>
Download an original or mp3 track
Query Params
user_id
<string>
The user ID of the user making the request
user_signature
<string>
Optional - signature from the requesting user's wallet.
This is needed to authenticate the user and verify access in case the track is gated.
user_data
<string>
Optional - data which was used to generate the optional signature argument.
nft_access_signature
<string>
Optional - nft access signature for this track which was previously generated by a registered DN.
We perform checks on it and pass it through to CN.
original
false
Optional - true if downloading original file
filename
<string>
Optional - name of file to download. If not provided, defaults to track original filename or title.
Path Variables
track_id
<string>
(Required) A Track ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/:track_id/download?user_id=%3Cstring%3E&user_signature=%3Cstring%3E&user_data=%3Cstring%3E&nft_access_signature=%3Cstring%3E&original=false&filename=%3Cstring%3E'
200 OK
Response
Body
Headers (0)
No response body
This request doesn't return any response body.
GET
Get Track Details
https://discoveryprovider.audius.co/v1/tracks/:track_id/inspect?original=false
Inspect a track
Query Params
original
false
Optional - if set to true inspects the original quality file
Path Variables
track_id
<string>
(Required) A Track ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/:track_id/inspect?original=false' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
json
{
"data": {
"content_type": "<string>",
"size": "<integer>"
}
}
GET
Get Track Top Listeners
https://discoveryprovider.audius.co/v1/tracks/:track_id/top_listeners?offset=<integer>&limit=<integer>&user_id=<string>
Get the users that have listened to a track the most
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
Path Variables
track_id
<string>
(Required) A Track ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/:track_id/top_listeners?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
json
{
"data": [
{
"value": "<Circular reference to #/components/schemas/top_listener detected>"
},
{
"value": "<Circular reference to #/components/schemas/top_listener detected>"
}
]
}
GET
Get Track Stems
https://discoveryprovider.audius.co/v1/tracks/:track_id/stems
Get the remixable stems of a track
Path Variables
track_id
<string>
(Required) A Track ID
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tracks/:track_id/stems' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"blocknumber": "<integer>",
"category": "<string>",
"cid": "<string>",
"id": "<string>",
"orig_filename": "<string>",
"parent_id": "<string>",
"user_id": "<string>"
},
{
"blocknumber": "<integer>",
"category": "<string>",
"cid": "<string>",
"id": "<string>",
"orig_filename": "<string>",
"parent_id": "<string>",
"user_id": "<string>"
}
]
}
playlists
This folder doesn't have a description.
GET
Get Playlist
https://discoveryprovider.audius.co/v1/playlists/:playlist_id?user_id=<string>
Get a playlist by ID
Query Params
user_id
<string>
The user ID of the user making the request
Path Variables
playlist_id
<string>
(Required) A Playlist ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/playlists/:playlist_id?user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
},
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
}
]
}
GET
Get Bulk Playlists
https://discoveryprovider.audius.co/v1/playlists?user_id=<string>&id=<string>&id=<string>
Gets a list of playlists by ID
Query Params
user_id
<string>
The user ID of the user making the request
id
<string>
The ID of the playlist(s)
id
<string>
The ID of the playlist(s)
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/playlists?user_id=%3Cstring%3E&id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
},
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
}
]
}
GET
Search Playlists
https://discoveryprovider.audius.co/v1/playlists/search?query=<string>&genre=<string>&genre=<string>&sort_method=popular&mood=<string>&mood=<string>&includePurchaseable=<string>&has_downloads=<string>
Search for a playlist
Query Params
query
<string>
The search query
genre
<string>
The genres to filter by
genre
<string>
The genres to filter by
sort_method
popular
The sort method
mood
<string>
The moods to filter by
mood
<string>
The moods to filter by
includePurchaseable
<string>
Whether or not to include purchaseable content
has_downloads
<string>
Only include tracks that have downloads in the track results
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/playlists/search?query=%3Cstring%3E&genre=%3Cstring%3E&sort_method=popular&mood=%3Cstring%3E&includePurchaseable=%3Cstring%3E&has_downloads=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
},
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
}
]
}
GET
Get Playlist By Handle and Slug
https://discoveryprovider.audius.co/v1/playlists/by_permalink/:handle/:slug?user_id=<string>
Get a playlist by handle and slug
Query Params
user_id
<string>
The user ID of the user making the request
Path Variables
handle
<string>
(Required) playlist owner handle
slug
<string>
(Required) playlist slug
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/playlists/by_permalink/:handle/:slug?user_id=%3Cstring%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
},
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
}
]
}
GET
Get Trending Playlists
https://discoveryprovider.audius.co/v1/playlists/trending?time=week
Gets trending playlists for a time period
Query Params
time
week
Calculate trending over a specified time range
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/playlists/trending?time=week' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
},
{
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"favorite_count": "<integer>",
"id": "<string>",
"is_album": "<boolean>",
"is_image_autogenerated": "<boolean>",
"permalink": "<string>",
"playlist_contents": [
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
},
{
"metadata_timestamp": "<integer>",
"timestamp": "<integer>",
"track_id": "<string>"
}
],
"playlist_name": "<string>",
"repost_count": "<integer>",
"total_play_count": "<integer>",
"track_count": "<integer>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"description": "<string>",
"ddex_app": "<string>",
"upc": "<string>"
}
]
}
GET
Get Playlist Access Info
https://discoveryprovider.audius.co/v1/playlists/:playlist_id/access-info?user_id=<string>&include_network_cut=<boolean>
Gets the information necessary to access the playlist and what access the given user has.
Query Params
user_id
<string>
The user ID of the user making the request
include_network_cut
<boolean>
Whether to include the staking system as a recipient
Path Variables
playlist_id
<string>
(Required) A Playlist ID
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/playlists/:playlist_id/access-info?user_id=%3Cstring%3E&include_network_cut=%3Cboolean%3E' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": {
"blocknumber": "<integer>",
"user_id": "<string>",
"access": {
"download": "<boolean>",
"stream": "<boolean>"
},
"is_stream_gated": "<boolean>",
"stream_conditions": {
"tip_user_id": "<integer>"
},
"is_download_gated": "<boolean>",
"download_conditions": {
"tip_user_id": "<integer>"
}
}
}
GET
Get Playlist Tracks
https://discoveryprovider.audius.co/v1/playlists/:playlist_id/tracks
Fetch tracks within a playlist.
Path Variables
playlist_id
<string>
(Required) A Playlist ID
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/playlists/:playlist_id/tracks' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
},
{
"artwork": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"comment_count": "<integer>",
"duration": "<integer>",
"favorite_count": "<integer>",
"genre": "<string>",
"id": "<string>",
"is_downloadable": "<boolean>",
"is_original_available": "<boolean>",
"permalink": "<string>",
"play_count": "<integer>",
"repost_count": "<integer>",
"title": "<string>",
"user": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"description": "<string>",
"track_cid": "<string>",
"preview_cid": "<string>",
"orig_file_cid": "<string>",
"orig_filename": "<string>",
"mood": "<string>",
"release_date": "<string>",
"remix_of": {
"tracks": [
{
"parent_track_id": "<string>"
},
{
"parent_track_id": "<string>"
}
]
},
"tags": "<string>",
"is_streamable": "<boolean>",
"ddex_app": "<string>",
"playlists_containing_track": [
"<integer>",
"<integer>"
]
}
]
}
tips
This folder doesn't have a description.
GET
Get Tips
https://discoveryprovider.audius.co/v1/tips?offset=<integer>&limit=<integer>&user_id=<string>&receiver_min_followers=0&receiver_is_verified=false¤t_user_follows=receiver&unique_by=receiver
Gets the most recent tips on the network
Query Params
offset
<integer>
The number of items to skip. Useful for pagination (page number * limit)
limit
<integer>
The number of items to fetch
user_id
<string>
The user ID of the user making the request
receiver_min_followers
0
Only include tips to recipients that have this many followers
receiver_is_verified
false
Only include tips to recipients that are verified
current_user_follows
receiver
Only include tips involving the user's followers in the given capacity. Requires user_id to be set.
unique_by
receiver
Only include the most recent tip for a user was involved in the given capacity.
Eg. 'sender' will ensure that each tip returned has a unique sender, using the most recent tip sent by a user if that user has sent multiple tips.
Example
Success
Request
View More
cURL
curl --location 'https://discoveryprovider.audius.co/v1/tips?offset=%3Cinteger%3E&limit=%3Cinteger%3E&user_id=%3Cstring%3E&receiver_min_followers=0&receiver_is_verified=false¤t_user_follows=receiver&unique_by=receiver' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"amount": "<string>",
"created_at": "<string>",
"sender": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"receiver": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
},
{
"amount": "<string>",
"created_at": "<string>",
"sender": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
},
"receiver": {
"album_count": "<integer>",
"erc_wallet": "<string>",
"followee_count": "<integer>",
"follower_count": "<integer>",
"handle": "<string>",
"id": "<string>",
"is_available": "<boolean>",
"is_deactivated": "<boolean>",
"is_verified": "<boolean>",
"name": "<string>",
"playlist_count": "<integer>",
"repost_count": "<integer>",
"spl_wallet": "<string>",
"supporter_count": "<integer>",
"supporting_count": "<integer>",
"total_audio_balance": "<integer>",
"track_count": "<integer>",
"verified_with_instagram": "<boolean>",
"verified_with_tiktok": "<boolean>",
"verified_with_twitter": "<boolean>",
"wallet": "<string>",
"artist_pick_track_id": "<string>",
"bio": "<string>",
"cover_photo": {
"640x": "<string>",
"2000x": "<string>"
},
"twitter_handle": "<string>",
"instagram_handle": "<string>",
"tiktok_handle": "<string>",
"website": "<string>",
"donation": "<string>",
"location": "<string>",
"profile_picture": {
"150x150": "<string>",
"480x480": "<string>",
"1000x1000": "<string>"
},
"spl_usdc_payout_wallet": "<string>"
}
}
]
}
developer_apps
This folder doesn't have a description.
GET
Get Developer App
https://discoveryprovider.audius.co/v1/developer_apps/:address
Gets developer app matching given address (API key)
Path Variables
address
<string>
(Required) A developer app address (API Key)
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/developer_apps/:address' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
json
{
"data": {
"address": "<string>",
"name": "<string>",
"user_id": "<string>",
"description": "<string>",
"image_url": "<string>"
}
}
GET
Get Developer Apps by User
https://discoveryprovider.audius.co/v1/users/:id/developer_apps
Gets the developer apps that the user owns
Path Variables
id
<string>
(Required) A User ID
Example
Success
Request
cURL
curl --location 'https://discoveryprovider.audius.co/v1/users/:id/developer_apps' \
--header 'Accept: application/json'
200 OK
Response
Body
Headers (1)
View More
json
{
"data": [
{
"address": "<string>",
"name": "<string>",
"user_id": "<string>",
"description": "<string>",
"image_url": "<string>"
},
{
"address": "<string>",
"name": "<string>",
"user_id": "<string>",
"description": "<string>",
"image_url": "<string>"
}
]
}
resolve
This folder doesn't have a description.
GET
Resolves and redirects a provided Audius app URL to the API resource URL it represents
https://discoveryprovider.audius.co/v1/resolve?url=<string>
This endpoint allows you to lookup and access API resources when you only know the
audius.co URL.
Tracks, Playlists, and Users are supported.
Query Params
url
<string>
(Required) URL to resolve. Either fully formed URL (https://audius.co) or just the absolute path
Example