npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

audius

v1.1.1

Published

🔊 Easy-to-use, promise-based API bindings for Audius.

Downloads

10

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. |