Spotify

🎶 Want to fetch the whole artist discography, including albums, compilations and Singles? Please use canadesk/spotify-plus!

⚡ This actor returns raw data. For a higher maximum (results and Custom Input), and simplified results, please use canadesk/spotify-plus.

💡 Some data will be returned based on the IP address location, such as nearby concerts.

Input

• Keywords (array)

  Returns data for the keywords.

  Expected format:

  • Get

    • Default: ID ("1uvyZBs4IZYRebHIB1747m?si=9b8c8c8393894e4b").

    • User: Name ("spotify") or ID.

    • 🆕 Lyrics: https://www.musixmatch.com/lyrics/{artist}/{song}

  • Search

    Any search terms ("purple rain prince").

• Custom Input (object)

  Alternative to/overrides Keywords.

  You can set a different process/category combination for each keyword.

  ⭐ For 5+ entries at a time, please use canadesk/spotify-plus!

• Process (select)

  • Get

    Returns data for the specified category. Requires a specific ID (or Name or URL).

  • Search

    Returns data for the specified category based on the search terms.

• Category (select)

  Each Process/Category combination must be valid.

  Possible options are:

  • Get

    "track", "artist", "album", "playlist", "homepage", "trackCredits", "relatedTrackArtists", "playlistMetadata", "playlistContents", "user", "section", "podcast", "podcastEpisodes", "episode", "trackLyrics", "images", "lyrics"

  • Search

    "track", "artist", "album", "playlist", "all", "user", "podcast"

• Language (select)

  Only applicable to combination: Get + Lyrics.

  Works as follows:

  1. "Default" returns the song lyrics in the original language.

  2. Any other choice will try to return the translation instead.

  3. For missing translations, the original language is returned.

• Maximum results (integer)

  Per keyword. For example, a limit of 50 will return the first 50 tracks of a given playlist.

  ⭐ For 200+ results, please use canadesk/spotify-plus!

• Batch (integer)

  Number of parallel requests to be executed - only relevant when there is more than 1 keyword.

  Default is 1. The higher the number, the more chances you have to be blocked.

  💡 Make sure to increase the Actor's memory and timeout for long runs!

• Delay (integer)

  For high-volume scraping, make sure to set a reasonable waiting time.

Example

✅ All "items" keys have been emptied for this example, but the data will be available in your results.

Get Artist returns:

{
	"id": "5a2EaR3hamoenG9rDuVn8j",
	"uri": "spotify:artist:5a2EaR3hamoenG9rDuVn8j",
	"saved": false,
	"sharingInfo": {
		"shareUrl": "https://open.spotify.com/artist/5a2EaR3hamoenG9rDuVn8j?si=AqCC3XXqTtK1F7P3BzZm7Q",
		"shareId": "AqCC3XXqTtK1F7P3BzZm7Q"
	},
	"profile": {
		"name": "Prince",
		"verified": true,
		"pinnedItem": {
			"comment": "Best of Prince",
			"type": "PLAYLIST",
			"backgroundImage": {
				"sources": [
					{
						"url": ""
					}
				]
			},
			"itemV2": {},
			"item": {
				"uri": "spotify:playlist:3jXMLVtLsok8PpCWFj8d5l",
				"name": "Prince: Greatest Hits",
				"images": {
					"items": []
				}
			}
		},
		"biography": {
			"type": "BIOGRAPHY",
			"text": "No artist of the rock & roll era compares to singer, songwriter, producer, and multi-instrumentalist Prince. He was the rare combination of a visionary pop conceptualist and master musician who could capture the sounds he imagined. This quality fueled his remarkable success throughout the 1980s, a decade in which he authored a string of nine gold, platinum, or multi-platinum albums that included 1999 (1982), Purple Rain (1984), and Sign 'o' the Times (1987)."
		},
		"externalLinks": {
			"items": []
		},
		"playlistsV2": {
			"totalCount": 8,
			"items": []
		}
	},
	"visuals": {
		"gallery": {
			"items": []
		},
		"avatarImage": {
			"sources": [
				{
					"url": "https://i.scdn.co/image/ab6761610000e5ebeaca358712b3fe4ed9814640",
					"width": 640,
					"height": 640
				},
				{
					"url": "https://i.scdn.co/image/ab6761610000f178eaca358712b3fe4ed9814640",
					"width": 160,
					"height": 160
				},
				{
					"url": "https://i.scdn.co/image/ab67616100005174eaca358712b3fe4ed9814640",
					"width": 320,
					"height": 320
				}
			],
			"extractedColors": {
				"colorRaw": {
					"hex": "#535353"
				}
			}
		},
		"headerImage": {
			"sources": [
				{
					"url": "https://i.scdn.co/image/ab67618600001016da4c8e34df72aa53d798faa3",
					"width": 2660,
					"height": 1140
				}
			],
			"extractedColors": {
				"colorRaw": {
					"hex": "#535353"
				}
			}
		}
	},
	"discography": {
		"latest": null,
		"popularReleasesAlbums": {
			"totalCount": 20,
			"items": []
		},
		"singles": {
			"totalCount": 28,
			"items": []
		},
		"albums": {
			"totalCount": 55,
			"items": []
		},
		"compilations": {
			"totalCount": 4,
			"items": []
		},
		"topTracks": {
			"items": []
		}
	},
	"stats": {
		"followers": 7566358,
		"monthlyListeners": 10755536,
		"worldRank": 0,
		"topCities": {
			"items": []
		}
	},
	"relatedContent": {
		"appearsOn": {
			"totalCount": 18,
			"items": []
		},
		"featuringV2": {
			"totalCount": 8,
			"items": []
		},
		"discoveredOnV2": {
			"totalCount": 100,
			"items": []
		},
		"relatedArtists": {
			"totalCount": 40,
			"items": []
		}
	},
	"goods": {
		"events": {
			"userLocation": {
				"name": "Brisbane"	// Based on IP address
			},
			"concerts": {
				"totalCount": 0,
				"items": [],
				"pagingInfo": {
					"limit": 0
				}
			}
		},
		"merch": {
			"items": []
		}
	}
}

Support

Open a new issue for bugs or feature requests. Please share the run URL.

Cheers!