Audius users API
User related operations
Audius users API is one of 21 APIs that Audius publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include User. The published artifact set on APIs.io includes an OpenAPI specification.
This API exposes 84 operations across 75 paths, and defines 138 schemas. It is described by OpenAPI 3.2.0, at version 1.0.
Requests are made against a single base URL, https://api.audius.co/v1.
84 operations
75 paths
138 schemas
5 DELETE70 GET8 POST1 PUT
Metadata
The identity and technical contract details declared by the specification.
Authentication & Security 3
Audius users API declares
3 security schemes
for authenticating requests.
It supports OAuth 2.0 (OAuth2) using the authorizationCode flow, exposing 2 scopes.
It accepts HTTP basic authentication (BasicAuth).
It accepts HTTP bearer tokens (JWT) (BearerAuth).
OAuth2— OAuth 2.0 Authorization Code flow with PKCE for third-party applications. Allows apps to authenticate users and obtain access tokens scoped to read or read+wri…BasicAuth— HTTP Basic Authentication with Ethereum private key for write operations. Authentication Use HTTP Basic Authentication where the password field contains your E…BearerAuth— The API bearer token or OAuth JWT token for the user.
Paths & Operations 84
Across 75 paths, the API surfaces 84 operations — 5 DELETE, 70 GET, 8 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.
users 84
User related operations
GET
/users
Gets a list of users by ID
POST
/users
Creates a new user
GET
/users/address
Gets User IDs from any Ethereum wallet address or Solana account address associated with their Audius account.
GET
/users/handle/{handle}
Gets a single user by their handle
GET
/users/handle/{handle}/tracks
Gets the tracks created by a user using the user's handle
GET
/users/handle/{handle}/tracks/ai_attributed
Gets the AI generated tracks attributed to a user using the user's handle
GET
/users/search
Search for users that match the given query
GET
/users/verify_token
Verify if the given jwt ID token was signed by the subject (user) in the payload
GET
/users/{id}
Gets a single user by their user ID
PUT
/users/{id}
Updates an existing user profile
GET
/users/{id}/albums
Gets the albums created by a user using their user ID
GET
/users/{id}/authorized_apps
Get the apps that user has authorized to write to their account
GET
/grantees/{address}/users
Get all users who have authorized a particular grantee (developer app) identified by their wallet address. Supports pagination.
GET
/users/{id}/balance/history
Get the user's historical portfolio balance data
GET
/users/{id}/challenges
Gets all challenges for the given user
GET
/users/{id}/coins
Gets a list of the coins owned by the user and their balances
GET
/users/{id}/coins/{mint}
Gets information about a specific coin owned by the user and their wallets
GET
/users/{id}/collectibles
Get the User's indexed collectibles data
GET
/users/{id}/comments
Get user comment history
GET
/users/{id}/connected_wallets
Get the User's ERC and SPL connected wallets
GET
/users/{id}/favorites
Gets a user's favorite tracks
GET
/users/{id}/followers
All users that follow the provided user
POST
/users/{id}/follow
Follow a user
DELETE
/users/{id}/follow
Unfollow a user
POST
/users/{id}/grants
Create a grant (authorize an app to act on the user's behalf)
DELETE
/users/{id}/grants/{address}
Revoke a grant (remove app authorization)
POST
/users/{id}/grants/approve
Approve a manager request (manager approves being added by the child user)
POST
/users/{id}/managers
Add a manager (authorize another user to act on your behalf)
GET
/users/{id}/managers
Gets a list of users managing the given user
DELETE
/users/{id}/managers/{managerUserId}
Remove a manager (revoke user-to-user grant). Can be called by the child user or the manager.
GET
/users/{id}/following
All users that the provided user follows
GET
/users/{id}/history/tracks
Get the tracks the user recently listened to.
GET
/users/{id}/listen_counts_monthly
Gets the listen data for a user by month and track within a given time frame.
GET
/users/{id}/muted
Gets users muted by the given user
POST
/users/{id}/muted
Mute a user
DELETE
/users/{id}/muted
Unmute a user
GET
/users/{id}/mutuals
Get intersection of users that follow followeeUserId and users that are followed by followerUserId
GET
/users/{id}/playlists
Gets the playlists created by a user using their user ID
GET
/users/{id}/purchasers
Gets the list of unique users who have purchased content by the given user
GET
/users/{id}/purchases/download
Downloads the purchases the user has made as a CSV file
GET
/users/{id}/recommended-tracks
Gets the recommended tracks for the user
GET
/users/{id}/related
Gets a list of users that might be of interest to followers of this user.
GET
/users/{id}/remixers
Gets the list of unique users who have remixed tracks by the given user, or a specific track by that user if provided
GET
/users/{id}/reposts
Gets the given user's reposts
GET
/users/{id}/sales/aggregate
Gets the aggregated sales data for the user
GET
/users/{id}/sales/download
Downloads the sales the user has made as a CSV file
GET
/users/{id}/sales/download/json
Gets the sales data for the user in JSON format
GET
/users/{id}/subscribers
All users that subscribe to the provided user
POST
/users/{id}/subscribers
Subscribe to a user
DELETE
/users/{id}/subscribers
Unsubscribe from a user
GET
/users/{id}/supporters
Gets the supporters of the given user
GET
/users/{id}/supporting
Gets the users that the given user supports
GET
/users/{id}/tags
Fetch most used tags in a user's tracks
GET
/users/{id}/tracks
Gets the tracks created by a user using their user ID
GET
/users/{id}/tracks/count
Gets the count of tracks created by a user
GET
/users/{id}/tracks/download_count
Gets the total download count for all tracks (and stems) owned by the user. Use for dashboard "Downloads" tile.
GET
/users/{id}/tracks/remixed
Gets tracks owned by the user which have been remixed by another track
GET
/users/{id}/withdrawals/download
Downloads the USDC withdrawals the user has made as a CSV file
GET
/users/{receiving_user_id}/emails/{grantor_user_id}/key
Gets the encrypted key for email access between the receiving user and granting user.
GET
/users/account/{wallet}
Gets the account for a given user
GET
/users/genre/top
Get the Top Users for a Given Genre
GET
/users/handle/{handle}/reposts
Gets the user's reposts by the user handle
GET
/users/subscribers
All users that subscribe to the provided users
POST
/users/subscribers
Get all users that subscribe to the users listed in the JSON request
GET
/users/top
Get the Top Users having at least one track by follower count
GET
/users/{id}/favorites/tracks
Gets a user's favorite tracks
GET
/users/{id}/feed
Gets the feed for the user
GET
/users/{id}/library/albums
Fetch a user's full library playlists
GET
/users/{id}/library/playlists
Fetch a user's full library playlists
GET
/users/{id}/library/tracks
Fetch a user's full library tracks
GET
/users/{id}/managed_users
Gets a list of users managed by the given user
GET
/users/{id}/purchasers/count
Gets the list of users who have purchased content by the given user
GET
/users/{id}/purchases
Gets the purchases the user has made
GET
/users/{id}/purchases/count
Gets the count of purchases the user has made
GET
/users/{id}/remixers/count
Gets the count of unique users who have remixed tracks by the given user, or a specific track by that user if provided
GET
/users/{id}/sales
Gets the sales the user has made
GET
/users/{id}/sales/count
Gets the count of sales the user has made
GET
/users/{id}/supporters/{supporter_user_id}
Gets the specified supporter of the given user
GET
/users/{id}/supporting/{supported_user_id}
Gets the support from the given user to the supported user
GET
/users/{id}/transactions/audio
Gets the user's $AUDIO transaction history within the App
GET
/users/{id}/transactions/audio/count
Gets the count of the user's $AUDIO transaction history within the App
GET
/users/{id}/transactions/usdc
Gets the user's $USDC transaction history within the App
GET
/users/{id}/transactions/usdc/count
Gets the count of the user's $USDC transaction history within the App
GET
/me
Get authenticated user
Schemas 138
The contract defines 138 schemas that model the data the API accepts and returns. The most detailed are track (81 properties), user (60 properties), playlist_without_tracks (40 properties), playlist (40 properties). Each schema is shown below with its type and property counts.
access
object
2 properties
2 required
user_comments_response
object
9 properties
7 required
track
object
81 properties
37 required
user_coin
object
9 properties
7 required
create_grant_request_body
object
1 property
1 required
extended_token_gate
object
2 properties
2 required
user_tracks_remixed_response
object
1 property
tags_response
object
1 property
grant
object
6 properties
6 required
playlist_artwork
object
4 properties
following_response
object
8 properties
7 required
managed_user
object
2 properties
2 required
reposts
object
8 properties
7 required
tip_gate
object
1 property
1 required
top_users_response
object
8 properties
7 required
sales_aggregate_response
object
1 property
comment_mention
object
2 properties
2 required
followers_response
object
8 properties
7 required
track_activity
transaction_history_response
object
8 properties
7 required
playlist_added_timestamp
object
3 properties
2 required
decoded_user_token
object
9 properties
8 required
user_subscribers
object
2 properties
1 required
mutual_followers_response
object
8 properties
7 required
playlist_library_explore_playlist_identifier
object
Reference to an explore playlist
2 properties
2 required
track_library_response
object
8 properties
7 required
user_coin_with_accounts
object
7 properties
6 required
user_coins_response
object
1 property
1 required
sale_json
object
14 properties
related
object
3 properties
activity
object
4 properties
4 required
user_playlist_library
object
User's playlist library with support for folders and playlists
1 property
1 required
cover_art
object
4 properties
user_tracks_download_count_response
object
1 property
1 required
playlists_response
object
8 properties
7 required
user_response_single
object
1 property
usdc_gate
object
2 properties
2 required
ddex_rights_controller
object
DDEX rights controller
3 properties
2 required
payment_split
object
2 properties
2 required
connected_wallets
object
2 properties
2 required
account
object
4 properties
3 required
balance_history_data_point
object
2 properties
2 required
tracks
object
8 properties
7 required
version_metadata
object
2 properties
2 required
balance_history_response
object
1 property
1 required
albums_response
object
8 properties
7 required
purchase_gate
object
1 property
1 required
user
object
60 properties
39 required
create_user_response
object
4 properties
listen_count
object
3 properties
sales_json_response
object
1 property
monthly_aggregate_play
object
3 properties
transaction_details
object
8 properties
8 required
sales_aggregate
object
3 properties
3 required
user_account_response
object
1 property
purchasers_count_response
object
8 properties
7 required
managed_users_response
object
1 property
collection_activity_without_tracks
repost
object
3 properties
3 required
sales_json_content
object
1 property
purchase_split
object
3 properties
2 required
playlist_without_tracks
object
40 properties
25 required
collectibles_response
object
1 property
url_with_mirrors
object
2 properties
1 required
access_gate
remix
object
4 properties
4 required
comment_entity_type
string
Type of entity that can be commented on
authorized_app
object
7 properties
5 required
bulk_subscribers_response
object
8 properties
7 required
top_genre_users_response
object
8 properties
7 required
history_response
object
8 properties
7 required
ddex_resource_contributor
object
3 properties
2 required
playlist_library
object
1 property
account_collection
object
5 properties
5 required
user_track_listen_counts_response
object
1 property
collectibles
object
1 property
user_feed_item
transaction_history_count_response
object
8 properties
7 required
cover_photo
object
3 properties
follow_gate
object
1 property
1 required
get_supported_users
object
8 properties
7 required
add_manager_request_body
object
1 property
1 required
supporter
object
3 properties
3 required
challenge_response
object
13 properties
9 required
remixed_track_aggregate
object
3 properties
3 required
get_supporters
object
8 properties
7 required
user_manager
object
2 properties
2 required
user_coin_response
object
1 property
supporting
object
3 properties
3 required
track_feed_item
object
2 properties
2 required
user_id_address
object
2 properties
2 required
get_supporting
object
8 properties
7 required
favorite
object
4 properties
4 required
playlist_feed_item
object
2 properties
2 required
user_response
object
8 properties
7 required
profile_picture
object
4 properties
related_artist_response
object
8 properties
7 required
remix_parent
object
1 property
get_supporter
object
8 properties
7 required
email_access
object
8 properties
8 required
purchasers_response
object
8 properties
7 required
connected_wallets_response
object
1 property
token_gate
object
1 property
1 required
update_user_request_body
object
Request body for updating user profile. All fields are optional.
21 properties
track_artwork
object
4 properties
user_feed_response
object
8 properties
7 required
field_visibility
object
6 properties
6 required
purchases_count_response
object
8 properties
7 required
reply_comment
object
14 properties
8 required
playlist_library_playlist_identifier
object
Reference to a playlist
2 properties
2 required
managers_response
object
1 property
playlist_library_folder
object
Folder containing nested playlists and folders
4 properties
4 required
user_search
object
1 property
get_challenges
object
1 property
ddex_copyright
object
2 properties
2 required
album_backlink
object
3 properties
3 required
tracks_count_response
object
1 property
1 required
collection_library_response
object
8 properties
7 required
approve_grant_request_body
object
1 property
1 required
user_coin_account
object
5 properties
5 required
remixers_count_response
object
8 properties
7 required
favorites_response
object
1 property
write_response
object
3 properties
account_collection_user
object
3 properties
2 required
purchase
object
12 properties
12 required
subscribers_response
object
8 properties
7 required
playlist
object
40 properties
25 required
user_ids_addresses_response
object
1 property
authorized_apps
object
1 property
wild_month_model
object
email_access_response
object
1 property
verify_token
object
1 property
comment
object
18 properties
8 required
remixers_response
object
8 properties
7 required
track_segment
object
2 properties
2 required
create_user_request_body
object
20 properties
2 required
stem_parent
object
2 properties
2 required
purchases_response
object
8 properties
7 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
Source
More from Audius 12
Other APIs Audius publishes across the network.
Audius REST API
Audius challenges API
Audius cid_data API
Audius coins API
Audius comments API
Audius dashboard_wallet_users API
Audius developer_apps API
Audius events API
Audius explore API
Audius notifications API
Audius playlists API
Audius prizes API
#User
Where this information came from
This is an independent, third-party profile of Audius users API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.