audius
v1.1.1
Published
🔊 Easy-to-use, promise-based API bindings for Audius.
Downloads
10
Maintainers
Readme
const Audius = require('audius')
// The app name is requested by Audius. It is not required but strongly encouraged.
// The API is open and no key is required.
const audiusApp = new Audius("My Cool App v1.0.2")
// Searching for a user
audiusApp.searchUsers('Skrillex').then(users => {
// Provided Skrillex was the first in the list, would print "Hey, Skrillex!"
console.log("Hey,", users[0].name + "!" )
})
| Name | Description | Parameters | Returns | |------------------------------------------------------- |-------------------------------------------- |-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |------------- | | Audius#searchUsers(search: String) | Find users by name. | search: The search term to find users by. | User[] | | Audius#searchTracks(search: String) | Find tracks by name. | search: The search term to find tracks by. | Track[] | | Audius#searchPlaylists(search: String) | Find playlists by name. | search: The search term to find playlists by. | Playlist[] | | Audius#getTrack(id: String) | Retrieve a track by ID. | id: The unique ID of the track. | Track | | Audius#getUser(id: String) | Retrieve a user by ID. | id: The unique ID of the user. | User | | Audius#getPlaylist(id: String) | Retrieve a playlist by ID. | id: The unique ID of the playlist. | Playlist | | Audius#getTrendingTracks(time: String, genre: String) | Get the top 100 trending tracks on Audius. | time: The time range of which to get trending tracks. Either "week", "month" or "allTime". If blank, defaults to "week".genre: The genre of which to get trending tracks for. If blank, defaults to any genre. | Track[] | | Audius#getPlaylistTracks(id: String) | Get the tracks of a playlist by ID. | id: The unique ID of the playlist. | Track[] | | Audius#getUserTracks(id: String) | Get the tracks uploaded by a user by ID. | id: The unique ID of the user. | Track[] | | Audius#getUserFavourites(id: String) | Get the favourites of a user by ID. | id: The unique ID of the user. | Favourite[] | | Audius#streamTrack(id: String, download: Boolean) | Stream the data of a track by ID. | id: The unique ID of the track.download: Whether to return once the entire file has been downloaded or return incomplete data that can be streamed. | Stream |
| Name | Description | Properties | |------------ |-------------------------------------------------------------------------------------------------------------------- |----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | User | A user profile. | albumCount: The number of albums this user has published.bio: The bio of the user.coverPhoto: A CoverPhoto containing three sizes of cover photo.following: The number of accounts this user is following.followers: The number of users that are following this account.handle: The permanent name of the user.id: The unique ID of the user.verified: Whether the user is verified or not.location: The location set on the user's profile.name: The customisable name on the user's profile.playlistCount: The number of playlists the user has published.profilePicture: An Artwork containing three sizes of profile picture.repostCount: The number of tracks the user has reposted.trackCount: The number of original tracks the user has published. | | Track | A music track. | artwork: An Artwork object containing links to three different sizes of artwork.description: The track's description.genre: The genre of the track.id: The unique ID of the track.mood: The mood of the track.releaseDate: The release date of the track.remixOf: The original track the track remixes, if any.repostCount: The number of times the track has been reposted.favouriteCount: The number of times the track has been favourited.playCount: The number of times the track has been played.tags: The track's tags that define its content.title: The title of the track.user: The user that uploaded the track.duration: The length of the track in seconds.downloadable: Whether or not the track is downloadable. | | Playlist | A playlist or album of multiple tracks. | artwork: An Artwork object containing links to three different sizes of artwork.description: The description of the playlist.id: The unique ID of the playlist.isAlbum: Whether the playlist is an album or not.name: The name of the playlist.repostCount: The number of times the playlist has been reposted.favouriteCount: The number of times the playlist has been favourited.totalPlayCount: The total number of track plays in the playlist.user: The user that made the playlist. | | Artwork | A piece of artwork shown on a track, playlist or profile picture. | small: The small 100x100 artwork.medium: The medium 480x480 artwork.large: The large 1000x1000 artwork. | | CoverPhoto | A cover photo on a user profile. | small: The small 640x640 cover photo.large: The large 2000x2000 cover photo. | | Favourite | A favourited item, such as a track. Does not contain the item itself, only the link between the user and the item. | id: The unique ID of the favourite.type: The type of Item this favourite is.userID: The unique ID of the user that made this favourite. |