Understanding my data

When you use the automated Download your data function, you will receive several files in JSON format. JSON stands for JavaScript Object Notation, and is a structured, commonly used format that is capable of being understood by both computers and human beings. Each file contains a different type of personal data as described below:


A summary of the playlists created or saved, and any songs saved, including:

  1. Name of playlist.
  2. Date the playlist was last modified.
  3. Names of songs contained within the playlist.
  4. Names of artists for each song.
  5. Names of albums or episodes (if podcasts). 
  6. Local track name, if the user uploaded locally saved audio to be played on Spotify service. 
  7. Any descriptions added by the user to the playlist.
  8. The number of followers the playlist has.
Streaming History (audio, video, and podcasts)

A list of items (e.g. songs, videos, and podcasts) listened to or watched in the past year, including:

  1. Date and time of when the stream ended in UTC format (Coordinated Universal Time zone).
  2. Name of "creator" for each stream (e.g. the artist name if a music track).
  3. Name of items listened to or watched (e.g. title of music track or name of video). 
  4. “msPlayed”- Stands for how many mili-seconds the track was listened. 
Your Library

A summary (at the point of the date of the request) of the content saved in Your Library (songs, podcasts, and videos), including:

  1. Name of artist for each item.
  2. Name of the album.
  3. Name of track saved.
Search queries 
A list of all searches made, including:
  1. The date the search was made.
  2. Type of device used (such as iOS, desktop)
  3. Country code of the search
  4. What action resulted (for example, timeout, another interaction etc). 
  5. msDuration: how many milliseconds this search lasted 
  6. Typed Query shows what the user typed in the search field. 
  7. Selected query explains what selection the user made from the available search options
  8. User intent displays if any actions taken by the user from the search results (for example, play the track or navigate forward [to show the track]).   
  9. View Uri: Uniform Resource Identifier (URI) is a string of characters that unambiguously identifies a particular resource. Schemes specifying a concrete syntax and associated protocols define each URI where available. 

This includes (where available) at the point of the request:

  1. The number of followers the account has.
  2. The number of other accounts this account is following.
  3. A list of artists the account is following.

This includes details of the payment method (where available):

  1. Type - The card type e.g. MasterCard, Visa etc, or other form of payment such as a Gift Card, Paypal.
  2. Card Number - Where the payment method is via card, this is the last four digits only.
  3. Card Expiry - Where the payment method is via card, this is the four digit expiry date (e.g. 07/18).
  4. Creation Date - The date the payment details were provided to Spotify.
  5. Payment Country - The country where the card was issued e.g. United Kingdom, Sweden.
  6. Postal Code - The postal code the card is registered to.
User Data

This includes (where available):

  1. Spotify username.
  2. Email address.
  3. Country.
  4. Created from Facebook - This shows true if the account was created via Facebook.
  5. Facebook user ID - This is included if the user has turned on Facebook data processing and linked their Spotify account by signing in using Facebook log-in or created their Spotify account via Facebook.
  6. Preferred locale.
  7. Date of birth.
  8. Gender.
  9. Postal code.
  10. Postal address. 
  11. Mobile number.
  12. Mobile operator.
  13. Mobile brand.
  14. Account creation - This is the user’s date of registration.
Family PlanFamily plan data (if you own a Premium for Family plan) which includes your address, city, country, name, state, street, and postal code. 

Technical log files

If you have also received a copy of your technical log data, look for the “Read Me First” file provided with your data for a detailed description of the data.  

Last updated: 17 September, 2019