1.1.0 • Published 4 years ago

@ipmanlk/spotify-grab v1.1.0

Weekly downloads
-
License
MIT
Repository
github
Last release
4 years ago

spotify-grab

Extract useful metadata from various Spotify URIs.

Installation

npm i @ipmanlk/spotify-grab

Usage

getInfo(URI) ⇒ Promise.<(Spotify.Info|undefined)>

Kind: global function
Returns: Promise.<(Spotify.Info|undefined)> - - Data extracted from the URI.
Throws:

  • SPOTIFY_URI_PARSE_ERROR - Unable to parse the given URI.
  • SPOTIFY_UNSUPPORTED_URI_TYPE - Given URI is not supported.
  • SPOTIFY_REQUEST_FAILED - Failed to send a request to Spotify.
ParamTypeDescription
URIstringSpotify URI in any format. Only URIs for tracks, artists, albums and playlists are supported.

Example

const { getInfo } = require("@ipmanlk/spotify-grab")

const URI = "https://open.spotify.com/track/6habFhsOp2NvshLv26DqMb?si=FkyYtDchRW-L8L2BlCweRw"

getInfo(URI).then(data => {
		console.log(data);
}).catch(error => {
		console.log(error);
});

 //* Output of the above code will take following shape,
{
  "type": "track", //* Type of the input URI
  "track": {       //* Object with the name of above type (dynamic)
    "id": "6habFhsOp2NvshLv26DqMb",
    "name": "Despacito",
    "preview_url": "https://p.scdn.co/mp3-preview/ce2ad348fa47",
    "album": {
      "name": "VIDA"
    },
    "explicit": false,
    "artists": [
      {
        "id": "4V8Sr092TqfHkfAA5fXXqG",
        "name": "Luis Fonsi",
        "uri": "spotify:artist:4V8Sr092TqfHkfAA5fXXqG"
      }
    ]
  }
}