Skip to content
A simple easy to use wrapper for the Spotify API.
Branch: master
Clone or download
Latest commit 9aac246 Apr 15, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
Images initial commit May 31, 2017
src No more typescript Apr 15, 2019
.gitignore initial commit May 31, 2017
.npmignore No more typescript Apr 15, 2019
README.md update readme Aug 17, 2017
index.js
package.json bump version Apr 15, 2019
yarn.lock No more typescript Apr 15, 2019

README.md

Node Spotify API 🚀 🎶

A simple to use API library for the Spotify REST API.

Installation

npm install --save node-spotify-api

API

Currently there are two methods available, search and request 🔍

Search

search is the EASIEST way to find an artist, album, or track.

search: function({ type: 'artist OR album OR track', query: 'My search query', limit: 20 }, callback);

Example

var Spotify = require('node-spotify-api');

var spotify = new Spotify({
  id: <your spotify client id>,
  secret: <your spotify client secret>
});

spotify.search({ type: 'track', query: 'All the Small Things' }, function(err, data) {
  if (err) {
    return console.log('Error occurred: ' + err);
  }

console.log(data); 
});

Note: The limit property is optional and the search will default to 20 if one is not supplied.

Usage with Promises

This package also optionally works with promises. Just omit the callback parameter and the search method returns a promise object containing the response:

var Spotify = require('node-spotify-api');

var spotify = new Spotify({
  id: <your spotify client id>,
  secret: <your spotify client secret>
});

spotify
  .search({ type: 'track', query: 'All the Small Things' })
  .then(function(response) {
    console.log(response);
  })
  .catch(function(err) {
    console.log(err);
  });

Request

request can be used to make API requests to any Spotify endpoint you supply.

Example

var Spotify = require('node-spotify-api');

var spotify = new Spotify({
  id: <your spotify client id>,
  secret: <your spotify client secret>
});

spotify
  .request('https://api.spotify.com/v1/tracks/7yCPwWs66K8Ba5lFuU2bcx')
  .then(function(data) {
    console.log(data); 
  })
  .catch(function(err) {
    console.error('Error occurred: ' + err); 
  });

Don't have a Spotify client id and client secret?

The Spotify API requires an authentication token to work. This package will perform all of the work of generating an authentication token for you, but you will still need to supply a client id and client secret.

Sign up for a Spotify developer account here. If you already have a Spotify account, you'll just have to log in. A membership can be paid or free, it makes no difference when it comes to using the Spotify API.

Once you're signed up, navigate to https://developer.spotify.com/my-applications/. You should be presented with the following page:

Applications

Click the button to "Create An App". Once you're at the next page, fill in the required fields.

Required

Submit the form and on the next page, you should be presented with a client id and secret.

Key

And you're all set!! 🎉

You can’t perform that action at this time.