Spotify Organic

Description

‍Spotify is a digital music service. This data source covers Spotify Organic — the library and following of one connected Spotify account: the artists it follows, the albums and tracks it has saved, and the playlists it owns, follows or collaborates on, with the follower count recorded once a day.

It connects only through a Spotify app that you create yourself, and the account needs an active Premium subscription. Spotify for Artists figures — streams, monthly listeners, saves, skips, demographics — have no API and cannot be extracted here. For campaign delivery and the streams attributed to your ads, use the Spotify Ads data source.

Setup guide

Follow our setup guide to connect Spotify Organic to Improvado.

Spotify Organic connects only through your own Spotify app: you create an app in the Spotify Developer Dashboard and paste its Client ID and Client Secret into Improvado. Improvado does not offer its own Spotify app for this data source.

1Create an app in the Spotify Developer Dashboard:

1.1Sign in to the Spotify Developer Dashboard with the Spotify account that will own the app. This account needs an active Spotify Premium subscription, otherwise Spotify refuses access to the data.

1.2Click Create app and enter any App name and App description, for example Improvado connector.

1.3In Redirect URIs, add all three Improvado redirect URIs, one for each Improvado region. Enter each value exactly, including https:// and the trailing slash:

• https://connections.improvado.io/stat_provider_client/oauth_redirect/spotify_organic/
• https://connections.eu.improvado.io/stat_provider_client/oauth_redirect/spotify_organic/
• https://connections.us.improvado.io/stat_provider_client/oauth_redirect/spotify_organic/

1.4Under Which API/SDKs are you planning to use?, select Web API. Accept the Developer Terms of Service and save the app.

1.5Open the Settings of the app. Copy the Client ID, then click View client secret and copy the Client Secret.

1.6A new Spotify app runs in Development Mode, which allows up to five Spotify users. To connect a Spotify account other than the app owner, add it under User Management in the app settings, with the name and email of that account.

2In Improvado, paste the Client ID and Client Secret into the connection form and click Authorize.

3Spotify opens. Sign in with the app owner or with an account added under User Management, and approve the request. Improvado asks for read-only access to the artists the account follows, its library, and its private and collaborative playlists (scopes user-follow-read, user-library-read, playlist-read-private and playlist-read-collaborative).

4After the connection process is completed, the Spotify Organic connection will appear in your Connected sources list.

5When the connection status is Active, and the account status column shows one account, you can move on to data extraction. Each connection has one account: the Spotify user who signed in.

6To extract data, follow the instructions on how to set up data extraction. The reports have no settings to fill in: each one reads a part of the connected Spotify account.

• Artists Entity: the artists the account follows, with their names, images and links.
• Albums Entity: the albums saved in the library of the account, with their artists, type, release date, UPC and copyrights.
• Tracks Entity: the tracks saved in the library of the account (Liked Songs), with their ISRC, duration, artists and album.
• Playlists Lifetime Incremental: the playlists the account owns or follows, one row per playlist per day, with the follower count and the number of tracks. The follower history builds up with each daily run. To track a playlist owned by someone else, follow it from the connected account.
• Playlist Items Entity: the tracks in the playlists the account owns or collaborates on, with when and by whom each track was added, and the track with its ISRC.

Schema information

The schema information shows all report types you can use to extract data from Spotify Organic.

Limits

Spotify for Artists data is not available. Streams, listeners, monthly listeners, saves, skips, playlist adds, listener demographics and discovery sources are Spotify for Artists data, and Spotify for Artists has no API, so this data cannot be extracted. Spotify also no longer returns the followers, popularity and genres of artists to new apps. Streams and listeners attributed to your ads are available in the Spotify Ads data source.

Playlists owned by Spotify are skipped. Spotify does not let new apps read its own playlists, such as its editorial and algorithmic playlists, even when the connected account follows them.

Follower history starts with your first extraction. Spotify returns only the current follower count of a playlist, so earlier days cannot be loaded.

Release notes

You can find information about the latest API changes in the Changelog section of the official Spotify Web API documentation.

Troubleshooting

Having trouble with your setup? Find solutions to common issues →