Skip to main content

Spotify Import Guide

stats.fm Plus required

To be able to import your Spotify streaming history, you need to have stats.fm Plus.

1. Request your data from Spotify

NEW
This method has been recently introduced since Spotify now allows you to request your data via the website. This is the easiest and most reliable way to request your data. You can still try the other methods if you want to.

In order to request the endsong.json files, simply press the correct buttons on the Spotify website.

  1. To get started, open the Privacy page on the Spotify website.

  2. Scroll down to the "Download your data" section.

    Screenshot of the Spotify privacy page with the "Download your data" section in focus
  3. Make sure to untick the box in the "Account data" panel.

  4. Make sure to tick the box in the "Extended streaming history" panel.

  5. At the end, your configuration should look like this:

    Screenshot of the Spotify privacy page with the "Download your data" section in focus with the correct configured options
  6. Press the "Request data" button.

2. Confirm your request

As soon as your request is accepted by Spotify, you'll receive a link to confirm the request in your email. Confirm it, and Spotify will start gathering your data.

Email showing the confirmation link to confirm your request

3. Turn on Sync streaming history to prevent a gap in your data

4. Wait until you receive your data

This can take a while. As Spotify states:
We're currently gathering a copy of your personal data. This shouldn't take longer than 30 days. But don't worry, we'll send you an email when it's ready.
That's still quite a long wait, but trust me: it's worth it :)

5. Download and extract the files

Once your data is ready to download, you'll get an email with a link to download a .ZIP file. You need to extract this file before proceeding. You can learn how to extract .ZIP files on this page.

danger

Never share your files with others! The data may contain a lot of personal information, depending on what Spotify has sent you.

Email showing the download link to your data

6. Upload your files

danger

You can only upload one endsong.json file at a time.

When you have your extracted .JSON files ready, go to https://stats.fm/import, login and click "Import a new file" button. Then, select your first endsong.json file. You have to upload files one by one.

After clicking selecting the file, your file will be sent to the stats.fm servers to be processed. This can take a few minutes. Meanwhile you can already upload your next file.

Import page showing uploaded imports and the button to import a new file

7. Wait for your streams to be processed

Once your streams have reached the stats.fm servers, they need to be processed. Duplicate streams will be filtered out, and there will be a lot of calculations made for each stream in order to save it securely in the database. This can take a while. Depending on the amount of streams and the amount of people importing their streams at once this can take just a few seconds up to a couple of hours.

tip

If you don't like staring at a webpage for a long time, you can close the tab while your streams are being processed.

8. Ready to go!

Congratulations! You can now view your full listening history, play count, and much more. Your future streams will be synced to the database automatically.