tubestat

API Reference

Spotify endpoints

Artist, track, playlist and user metrics. Artist responses include monthly listeners, world rank and the top listener cities.

All 4 endpoints below take a single url parameter and return the same field vocabulary used across every platform. A full object costs 2 credits; a single field costs 1.
GET /api/v1/spotify/artist
2 credits cache 1m

Spotify artist

Monthly listeners, followers and world rank for a Spotify artist, plus top listener cities.

Parameters

url required
Example: https://open.spotify.com/artist/ARTIST_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

artistId · name · followers · monthlyListeners · worldRank · topCities

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/spotify/artist?url=https%3A%2F%2Fopen.spotify.com%2Fartist%2FARTIST_ID"
GET /api/v1/spotify/track
2 credits cache 1m

Spotify track

Play count and duration for a Spotify track.

Parameters

url required
Example: https://open.spotify.com/track/TRACK_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

trackId · name · views · belowThreshold · durationMs · artistIds

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/spotify/track?url=https%3A%2F%2Fopen.spotify.com%2Ftrack%2FTRACK_ID"
GET /api/v1/spotify/playlist
2 credits cache 1m

Spotify playlist

Follower and track counts for a Spotify playlist.

Parameters

url required
Example: https://open.spotify.com/playlist/PLAYLIST_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

playlistId · name · followers · ownerUserId · tracks

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/spotify/playlist?url=https%3A%2F%2Fopen.spotify.com%2Fplaylist%2FPLAYLIST_ID"
GET /api/v1/spotify/user
2 credits cache 1m

Spotify user

Follower, following and public playlist counts for a Spotify user.

Parameters

url required
Example: https://open.spotify.com/user/USER_ID
field optional
Return a single value for 1 credit instead of 2.

Fields

userId · name · followers · following · publicPlaylists

Example request

curl -H "Authorization: Bearer $TUBESTAT_KEY" \
  "https://tubestat.co/api/v1/spotify/user?url=https%3A%2F%2Fopen.spotify.com%2Fuser%2FUSER_ID"