Needlessly Provoking Marsupials
    Wondering what’s next for npm?Check out our public roadmap! »


    0.1.3 • Public • Published


    A node.js wrapper for Beats Music Developer API. Module is still under development so there are bugs. Feel free to file an issue. Getting Started

    1. Install Via npm

    Install the module via the npm CLI tool.

    npm install nodebeats --save

    2. Get Beats Music credentials

    To use nodebeats you must first register a developer account through the developer portal and create a new application. Each application will have a key and secret which you will use later.

    3. Initialize Client

    Using the credentials from the previous step, you can now initialize nodebeats and start making API calls through the returned client.

    The Beats API has both public and private endpoints. Providing the clientSecret is optional but provides you access to all the functionality of the Beats API.

    var Beats = require('nodebeats');
    var beatsClient = Beats.init(clientId, clientSecret);

    If init() is called without passing in parameters, nodebeats looks for the environmental variables process.env.BEATS_CLIENT_ID and process.env.BEATS_CLIENT_SECRET.

    4. Make Requests

    Once you obtain the client, you can use it to start making requests to the Beats API. To see what you can do refer the the docs (coming soon)

    beatsClient.getSearchResults('Dr. Dre', 'artist', function (err, data) {
      // Do something

    Authenticated Requests

    Nodebeats also lets you access user resources. This includes getting user information, editing playlists, and getting recommendations. To access these resources, you must login with the user's credentials. The entire OAuth process is handled for you including getting a token and refreshing it when necessary.

    beatsClient.login(username, password, function(err, data) {
      beatsClient.getPlaylistsForUser(function (err, data) {
        // Do something

    Once the user has been logged in, there is no need to login for future authenticated requests.


    npm i nodebeats

    DownloadsWeekly Downloads






    Last publish


    • avatar