Spotify Import Guide
To be able to import your Spotify streaming history, you need to have stats.fm Plus.
1. Request your data from Spotify
- Live Chat
In order to request the
endsong.json files, simply press the correct buttons on the Spotify website.
To get started, open the Privacy page on the Spotify website.
Scroll down to the "Download your data" section.
Make sure to untick the box in the "Account data" panel.
Make sure to tick the box in the "Extended streaming history" panel.
At the end, your configuration should look like this:
Press the "Request data" button.
endsong.jsonfiles, you'll need to send a simple email to firstname.lastname@example.org. You can login with your Spotify below to generate the email automatically or fill in the text yourself after copying it.
In order to request the
endsong.json files, simply contact Spotify's support via their live chat. Past experience has shown that this method to initiate the request for the files is more reliable, simpler and less error-prone than via the mail.
To get started, open the Spotify Support page. Then, click on "Start messaging" to start a live chat conversation. This will start a connection with a bot that will guide you through the process.
When asked about the topic or the issue, select "Data & privacy". If no such option is coming up, just type "Data & privacy" in the chat and hit Enter.
After that, select the option "Download / access my data".
- In the next step you are asked if you would like technical log information / extended streaming history. This is the data package you need! To request it, click the option "No, I want more data".
- Have a little conversation with the agent that you get assigned, and make sure that they are giving you the right files!
- Finally, you'll receive an email to confirm that data request. You can close the chat.
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.
3. Turn on Sync streaming history to prevent a gap in your data
4. Wait until you receive your dataThis 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.
Never share your files with others! The data may contain a lot of personal information, depending on what Spotify has sent you.
6. Upload your files
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.
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.
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.