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.

info

Spotify has changed the files they provided, upload all JSON files you received from Spotify excluding the video JSON file(s).

1. Request your data from Spotify

In order to request the extended streaming history 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.

  3. Configure the page so it looks like the screenshot below (Unticked the "Account data" and ticked the "Extended streaming history" boxes).

    Screenshot of the Spotify privacy page with the "Download your data" section in focus with the correct configured options, unticked "Account data" and ticked "Extended streaming history"
  4. 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 streams 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. Import your files

info

After you downloaded the files to your device and extracted them, you can choose between either uploading the files via the stats.fm web import page or via the integrated in-app import on mobile.

info

You can only upload one file at a time via the website.

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 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.

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.

No importable files present in the files you received? Check out this article.

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. For every uploaded file, you will receive a notification from the stats.fm app about the status of the uploaded file.

File import failed? Please attempt to upload the errored file(s) again.

7. 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.