Import Spotify Data to Google Sheets

In this guide, we’ll walk through how to pull Spotify music data directly into Google Sheets, using the API Connector add-on for Sheets.

Contents

• Before You Begin
• Part 1: Connect to the Spotify API
• Part 2: Create your Spotify API Request URL
• Part 3: Pull Spotify API Data into Sheets
• Part 4: More Example API URLs
• Part 5: API Documentation

Before You Begin

Click here to install the API Connector add-on from the Google Marketplace.

Part 1: Connect to the Spotify API

If you haven’t connected API Connector to Spotify before, you’ll first need to initiate the connection as follows:

1. Open up Google Sheets and click Extensions > API Connector > Manage Connections.
2. In the list of available connections, find Spotify and click Connect.
   
   
3. You will be directed to spotify.com and asked to authorize the connection. Click Agree.
   
   
4. You’ll then be returned to your Google Sheet, and can verify that your Spotify connection is active in the Connections screen.
   
   

Part 2: Create Your Spotify API Request URL

For our first request, we’ll get some basic information about your Spotify account.

• API root: https://api.spotify.com
• Endpoint: /v1/me

Putting it all together, we get the full API Request URL.

https://api.spotify.com/v1/me

Part 3: Pull Spotify API Data into Sheets

Now let’s copy that into API Connector.

1. In API Connector, click Create, and paste in the Request URL we created above.
   
   
2. Under OAuth, choose Spotify from the dropdown menu. You should see a “Connected” badge.
   
3. We don’t need any headers so just leave that section as is.
   
4. Create a new tab and click Set current to use that tab as your data destination.
5. Name your request and click Run. A moment later you’ll see some information about yourself populate your sheet.
   

Part 4: More Example API URLs

Now that we’ve got the basic handshake down, let’s get some more interesting data. Try the following URLs (one at a time).

• Get your own most played tracks

  https://api.spotify.com/v1/me/top/tracks?time_range=long_term

  
• Get your own most played artists

  https://api.spotify.com/v1/me/top/artists?time_range=long_term

• Get your recently played tracks

  https://api.spotify.com/v1/me/player/recently-played

  
• Search for artists matching a keyword

  https://api.spotify.com/v1/search?q=radio&type=artist

• Search for tracks matching a keyword

  https://api.spotify.com/v1/search?q=radio&type=track

• Get audio features of a list of track IDs

  https://api.spotify.com/v1/audio-features?ids=7ouMYWpwJ422jRcDASZB7P,4VqPOruhp5EdPBeR92t6lQ,37R0bQOQj5a7DOqh1TGzvB

  

Part 5: API Documentation

To see more API endpoints and example responses, I suggest checking out out the Spotify Web API reference located at https://developer.spotify.com/documentation/web-api/reference