General

Data and Limitations

Account and Legal

Contact

What is SpotDB?

SpotDB is a platform that lets you search for all (or most) entries on Spotify, including but not limited to albums, profiles, artists, playlists, tracks, and more!
SpotDB is completely open-source, and uses the official Spotify WebAPI.

How to use SpotDB - A guide

SpotDB is a platform for fetching public information from Spotify. Let us guide you through the process and leave additional tips!



- Searching & finding anything
In the home page or via the navigation bar search bar you can search up a keyword and find all results: albums, playlists, shows, artists, tracks, etc.
The Top results will help you find the most relevant items, while scrolling and looking through more items will show all items.
For a more advanced search, use the Filters on the left to change the Region (market) and/or the amount of results (default: 12)

Once you find what you were looking for, click on the item!



- Item pages (/r/[ID])
Once you open an item, you will see all information about it, including a table with most relevant information, tabs with information like artists, tracklist, images, etc depending on the item type (album, artist, track, etc)



- Users (/users & /r/[username])
To search for users, go to the Users page, and search for a username. Note that you can only search for exact usernames and/or the exact user ID, not display names.
Once you find the user you were looking for, click on it to open their profile page, where you can see their public playlists, and other information, if it exists.



- Other tips
IDs are important - they will always lead to the correct item; to the correct page; to the correct Spotify URL; etc.
Explicit tags - if a track is explicit, it will show an "E" tag next to the track name.
Embeds - you can embed albums, tracks, playlists, artists, episodes and shows using the "Embed" tab on each item page.
Copy Spotify URL - you can copy the Spotify URL of any item using the "Copy Spotify URL" button on each item page.
Open in Spotify - you can open any item in Spotify using the "Open in Spotify" button on each item page. Works on mobile *and* PC!


Even though we use the official Spotify API, there still are limitations. Find out more here.

Where do we find this data?

SpotDB uses the official Spotify WebAPI to complete certain tasks, such as search, fetch data, gather all information and more.

  • Spotify WebAPI - here - for searching and fetching data straight from Spotify

  • Even though we use the official Spotify API, there still are limitations. Find out more here.

    Can I contribute to SpotDB?

    Yes, SpotDB is open-source. You can contribute by visiting the GitHub repository, creating Issues and more. Extremely grateful for all help :)

    Where can I get the source code?

    The source code is available in our GitHub repository!

    What language is SpotDB written in?

    SpotDB is a vanilla HTML/CSS/Javascript website together with Node.js + Express backend. yes it's very bad lol

    Does SpotDB have an API? Is SpotDB an API?

    No, we directly fetch Spotify data and if you need that data, you should fetch from there too. The Spotify WebAPI is completely free and easy to get started with, and you will find it here.

    We are an open-source and free-to-use website made by a single random person for fun! Respectfully, I can't just create APIs out of nowhere and maintain them.

    Why are there no charts, streams, etc.?

    SpotDB directly fetches data straight from Spotify and currently, the Spotify WebAPI does not provide such data.
    In the long term, we may start using third-party and/or external APIs to get such data, if needed, although that likely will not happen for several reasons, the main one being that it goes against the main premise of SpotDB showing official Spotify data.
    Currently, we gather all data that Spotify officially provides to their public API, so no, don't expect everything to be included, including the charts, streams, or the song itself.

    What can I search?

    You can pretty much search for everything on Spotify, with one exception.

    Albums, tracks (+ EPs), artists, playlists, episodes and shows. To see how to find Spotify users on SpotDB, click here.

    ID

    Each item in Spotify has a unique ID, that looks something like "4PTG3Z6ehGkBFwjybzWkR8" (a real ID). There cannot be two items with the same ID.

    Note: some IDs could be broken or lead to either wrong or confusing pages, like the username *and* ID "undefined"

    Copyrights

    Copyrights are labels defined by the item's record label, artist or publisher, and represent who owns this item, legally speaking. There's more to this information, such as artists owning the songwriting rights, and more.

    Region (Market)

    Most items include "available_markets", which defines where this item can be found. There are multiple releases that are region-locked and can only be found there. This is defined by the item's record label, artist or publisher.

    External IDs

    Most items include "external_ids", which are IDs completely unrelated to the Spotify unique item ID. Examples of these external_ids can be the UPC or ISBN IDs.

    Embed

    You can embed Spotify albums, tracks, playlists, artists, episodes and shows, using an iframe embed. On all items excluding users you can easily generate these embeds, preview them, and copy the code from the "Embed" tab. You can customize the width and height and use them in your websites, HTML projects, and more.

    You leaked this!

    Oh well. Once again, we fetch details from the Spotify WebAPI, and if something has been leaked, we are not the ones involved.
    We control NOTHING, and it is purely the fault of the Spotify WebAPI and/or more likely the labels/artists/publishers releasing the wrong data or just too soon. We are a platform to fetch PUBLIC data.

    Do I have to sign in to use SpotDB?

    Nope!
    The way SpotDB works is when you open SpotDB, a Spotify API access token is generated, which is a temporary anonymous token only for you! Note that we do not see any token(s) and/or data, nor does that data include anything sensitive.
    Anyway, with said access token, you can search, fetch data, and more without having to ever sign-in, sign-up, connect your Spotify account, or anything else!.

    In the future, an optional Spotify sign-in feature could be created for some additional features, like viewing your profile, but that's for later!

    Legal

    SpotDB is unaffiliated with Spotify and/or any labels, artists, record companies, etc. If there's something wrong, please contact me.

    Contact us - feedback, questions, bugs

    SpotDB is a passion project by sipped (GitHub link), and if you'd like to contact me, please e-mail me at hello@sipped.org.