Skip to main content

Spotify Import Guide

stats.fm Support
  • Updated

Importing your Spotify streaming history requires stats.fm Plus/Pro.

1. Request your data from Spotify

To request your extended streaming history files:

  1. Open the Privacy page on the Spotify website
  2. Scroll down to the "Download your data" section
  3. Untick "Account data" and tick "Extended streaming history"
  4. Press the "Request data" button

Make sure you only tick "Extended streaming history" — the other two packages (Account data and Technical log information) don't contain the files stats.fm needs. If you tick the wrong box, you'll have to request the right package separately, which adds 2-3 weeks of waiting.

2. Confirm your request

Spotify will send you an email with a link to confirm your request. Click the link to confirm — once you do, Spotify will start gathering your data.

3. Turn on Sync streams to avoid gaps

While you're waiting for Spotify to prepare your data (which can take up to 30 days, usually 2-3 weeks), enable sync in the stats.fm app so new streams keep being tracked in the meantime.

In the app, go to Settings → Connections → Sync streams and make sure it's turned on. This way, anything you listen to during the wait period gets captured automatically, and your imported history will be complete when you upload the file.

4. Wait for your data

This can take a while. Spotify states it shouldn't take longer than 30 days, though the actual wait is usually 2-3 weeks. You'll get an email when your data is ready.

5. Download the files

When your data is ready, you'll get a second email with a link to download a .zip file containing your streaming history.

Never share your data files with others. They may contain personal information, depending on what Spotify included.

6. Import your files

You have two options for uploading: through the stats.fm web import page or directly in the app on mobile.

Web import

  1. Go to stats.fm/import and make sure you're logged in
  2. Drag and drop your files into the upload area, or click to open a file picker
  3. Select the .json files from your downloaded data
  4. Press the Upload button in the top right

Your files will be processed, which can take anywhere from a few seconds to a couple of hours depending on how many streams you have. You can close the tab while it processes — you'll get a notification in the stats.fm app for each file when it's done.

App import (mobile)

  1. Open the stats.fm app
  2. Go to your import settings
  3. Tap to select your files and upload

If you don't see any importable files, you may have downloaded the wrong package — see the Import FAQ for details on the three Spotify data packages and how to get the right one.

If a file import fails, try uploading the errored file again. If it still doesn't work, see our import troubleshooting guide.

7. You're done

You can now view your full listening history, exact play counts, and the deeper stats that come with imported data. Your future streams will keep syncing automatically.