Spotify API by APISH

Get public Spotify data as clean, consistent JSON: spotify album with tracks, spotify artist (monthly listeners, top tracks, discography), spotify artist discography, spotify podcast episode, spotify playlist, spotify podcast and more. 9 endpoints, one response shape, numbers parsed, absolute URLs.

How to use

1. Pick an Endpoint. Each option shows what it returns and its price in credits.
2. Enter its Parameters as JSON, for example {"url":"https://open.spotify.com/album/1NAmidJlEaVgA3MpcPFYGq"}. All parameters are listed below.
3. Run. Each call becomes one row in the dataset. Use Batch to run the same endpoint for many inputs and Pages per input to follow pagination.

Pricing

Pay per event: you pay per APISH credit the call used. The price of each endpoint is in the table below. Calls that fail on our side (server errors, timeouts, blocks) are free.

Endpoints

Endpoint	Returns	Required parameters	Credits
/spotify/v1/album	Spotify album with tracks	url	1
/spotify/v1/artist	Spotify artist (monthly listeners, top tracks, discography)	url	1
/spotify/v1/artist/discography	Spotify artist discography	url	1
/spotify/v1/episode	Spotify podcast episode	url	1
/spotify/v1/playlist	Spotify playlist	url	1
/spotify/v1/podcast	Spotify podcast	url	1
/spotify/v1/podcast/episodes	Spotify podcast episodes	url	1
/spotify/v1/search	Search Spotify	q	1
/spotify/v1/track	Spotify track	url	1

Output

Each dataset row has endpoint, params, status, credits_used and the endpoint's data. Add "raw": 1 to the parameters to also get the site's original record, or "fields": "a,b.c" to return only the fields you need.

Endpoint details

Spotify album with tracks

Endpoint /spotify/v1/album · 1 credit per successful call.

Parameters:

• url (required)
• offset

Example parameters: {"url":"https://open.spotify.com/album/1NAmidJlEaVgA3MpcPFYGq"}

Spotify artist (monthly listeners, top tracks, discography)

Endpoint /spotify/v1/artist · 1 credit per successful call.

Parameters:

• url (required)

Example parameters: {"url":"https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02"}

Spotify artist discography

Endpoint /spotify/v1/artist/discography · 1 credit per successful call.

Every release of an artist (albums, singles, EPs, compilations), paged. Every response includes credits_used: the credits this call cost.

Parameters:

• url (required): Artist URL (or id).
• type — one of all, album, single, compilation, ep: all (default), album, single, compilation, ep.
• order: newest (default) or oldest.
• offset: Value of next_offset from the previous page.
• limit: Up to 100 (default 50).

Example parameters: {"url":"https://open.spotify.com/artist/06HL4z0CvFAxyc27GXpf02"}

Spotify podcast episode

Endpoint /spotify/v1/episode · 1 credit per successful call.

Parameters:

• url (required)

Example parameters: {"url":"https://open.spotify.com/episode/24C6qd4r0IKDGkytUzYUnM"}

Spotify playlist

Endpoint /spotify/v1/playlist · 1 credit per successful call.

Parameters:

• url (required)
• offset

Example parameters: {"url":"https://open.spotify.com/playlist/37i9dQZF1DXcBWIGoYBM5M"}

Spotify podcast

Endpoint /spotify/v1/podcast · 1 credit per successful call.

Parameters:

• url (required)

Example parameters: {"url":"https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk"}

Spotify podcast episodes

Endpoint /spotify/v1/podcast/episodes · 1 credit per successful call.

Parameters:

• url (required)
• offset

Example parameters: {"url":"https://open.spotify.com/show/4rOoJ6Egrf8K2IrywzwOMk"}

Search Spotify

Endpoint /spotify/v1/search · 1 credit per successful call.

Parameters:

• q (required)
• type: tracks, albums, artists, playlists, podcasts or episodes.
• offset

Example parameters: {"q":"lofi"}

Spotify track

Endpoint /spotify/v1/track · 1 credit per successful call.

Parameters:

• url (required)

Example parameters: {"url":"https://open.spotify.com/track/0V3wPSX9ygBnCm8psDIegu"}

Support

Questions, bugs or a missing field? Open an issue in this Actor's Issues tab and we will reply there.

Public data only: nothing behind a login. You are responsible for how you use the data you collect.