1.1.0 • Published 11 months ago

spotify-finder-nextgen v1.1.0

Weekly downloads
-
License
MIT
Repository
-
Last release
11 months ago

Spotify Finder Nextgen

A Node.js module for interacting with Spotify's API, providing functions to search for queries and fetch details about artists, songs, and playlists.

Installation

To install the module, run:

npm install spotify-finder-nextgen

Usage

Importing the Module

In a CommonJS environment:

const { search, artist, song, playlist } = require('spotify-finder-nextgen');

In an ES module environment:

import { search, artist, song, playlist } from 'spotify-finder-nextgen';

Functions

search(query: string): Promise<any>

Search for a query in Spotify. Returns search results.

Parameters:

  • query (string): The search query. Links are not allowed.

Example:

(async () => {
  try {
    const results = await search('Duvet');
    console.log(results);
  } catch (error) {
    console.error(error);
  }
})();

Result JSON:

{
  "songs": [
    {
      "title": "Faded (Raw)",
      "subtitle": "Song • Illest Morena",
      "imageUrl": "https://i.scdn.co/image/ab67616d00001e023fe0c03eeae2ff5e1dc1f26f",
      "url": "https://open.spotify.com/track/title-5AxEGHRwgBqFDZ20ilkCw6"
    }
    // More results...
  ],
  "artists": [
    {
      "title": "Illest Morena",
      "subtitle": "Artist",
      "imageUrl": "https://i.scdn.co/image/ab6761610000e5eb3b543ea28fd14957c84d03cb",
      "url": "https://open.spotify.com/artist/title-2zRoFfKfqM5jaUysSG9EUI"
    }
    // More results...
  ],
  "playlists": [
    {
      "title": "geng geng playlist",
      "subtitle": "Playlist",
      "imageUrl": "https://image-cdn-ak.spotifycdn.com/image/ab67706c0000da8423376c1b45353026e9155c9b",
      "url": "https://open.spotify.com/playlist/title-68m9Cno8OO81Y5OnlrtpEh"
    }
    // More results...
  ]
}

artist(link: string): Promise<any>

Fetch details about a specific artist.

Parameters:

  • link (string): The Spotify artist link.

Example:

(async () => {
  try {
    const artistDetails = await artist('https://open.spotify.com/artist/5jTtGLk1mGFMY5lQOvJYUj');
    console.log(artistDetails);
  } catch (error) {
    console.error(error);
  }
})();

Result JSON:

{
  "artistName": "bôa",
  "artistProfile": "https://i.scdn.co/image/ab67616100005174d699423e4d35ff7a7fb66b7d",
  "about": {
    "monthlyListeners": "8,008,828 monthly listeners",
    "description": "bôa is a British alt-rock band originally formed in London in 1992. ...",
    "socialMedia": [
      {
        "platform": "Facebook",
        "link": "https://facebook.com/...."
      },
      {
        "platform": "Instagram",
        "link": "https://instagram.com/...."
      }
    ]
  },
  "popularSongs": [
    {
      "title": "Duvet",
      "plays": "476,425,699",
      "image": "https://i.scdn.co/image/ab67616d000048519e030b804258dc2017ad859f"
    }
    // More results...
  ],
  "albums": [
    {
      "title": "Twilight",
      "year": "Album • 2010",
      "image": "https://i.scdn.co/image/ab67616d00001e029e030b804258dc2017ad859f",
      "link": "https://open.spotify.com/album/7sGYAV0xv7ZfAMzIpMl8m1"
    }
    // More results...
  ],
  "singlesAndEPs": [
    {
      "title": "Twilight",
      "year": "Album • 2010",
      "image": "https://i.scdn.co/image/ab67616d00001e029e030b804258dc2017ad859f",
      "link": "https://open.spotify.com/album/7sGYAV0xv7ZfAMzIpMl8m1"
    }
    // More results...
  ],
  "featuring": [
    {
      "title": "Twilight",
      "year": "Album • 2010",
      "image": "https://i.scdn.co/image/ab67616d00001e029e030b804258dc2017ad859f",
      "link": "https://open.spotify.com/album/7sGYAV0xv7ZfAMzIpMl8m1"
    }
    // More results...
  ],
  "onTour": [],
  "artistPlaylists": [
    {
      "title": "Twilight",
      "image": "https://i.scdn.co/image/ab67616d00001e029e030b804258dc2017ad859f",
      "link": "https://open.spotify.com/album/7sGYAV0xv7ZfAMzIpMl8m1"
    }
    // More results...
  ]
}

song(link: string): Promise<any>

Fetch details about a specific song.

Parameters:

  • link (string): The Spotify track link.

Example:

(async () => {
  try {
    const songDetails = await song('https://open.spotify.com/track/0wEeW8Bwr0fHXuS2zLiDXk');
    console.log(songDetails);
  } catch (error) {
    console.error(error);
  }
})();

Result JSON:

{
  "title": "Duvet - Sped Up Version",
  "artist": "bôa",
  "image": "https://i.scdn.co/image/ab67616d00001e02786d2ae38a7a469bf4218d4a",
  "duration": "3:02",
  "lyrics": "And you don't seem to understand ...",
  "audio": "http://puppeteer-scrape-production.up.railway.app/spotify/downloads/Duvet---Sped-Up-Version.mp3"
}

playlist(link: string): Promise<any>

Fetch details about a specific playlist.

Parameters:

  • link (string): The Spotify playlist link.

Example:

(async () => {
  try {
    const playlistDetails = await playlist('https://open.spotify.com/playlist/37i9dQZEVXbNBz9cRCSFkY');
    console.log(playlistDetails);
  } catch (error) {
    console.error(error);
  }
})();

Result JSON:

{
  "title": "Top 50 - Philippines",
  "image": "https://charts-images.scdn.co/assets/locale_en/regional/daily/region_ph_default.jpg",
  "description": "Your daily update of the most played tracks right now - Philippines.",
  "saves": "1,361,515 saves",
  "tracks": [
    {
      "title": "sining (feat. Jay R)",
      "artist": "Dionela, Jay R",
      "image": "https://i.scdn.co/image/ab67616d0000485119f16592da6f918a04ef6b7c"
    }
    // More tracks...
  ]
}

License

MIT License. See LICENSE for details.

1.1.0

11 months ago

1.0.0

12 months ago

0.5.0

12 months ago

0.1.5

12 months ago

0.1.4

12 months ago

0.1.3

12 months ago

0.1.2

12 months ago

0.1.1

12 months ago

0.1.0

12 months ago