Spotify

⚡ 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:

1{
2	"id": "5a2EaR3hamoenG9rDuVn8j",
3	"uri": "spotify:artist:5a2EaR3hamoenG9rDuVn8j",
4	"saved": false,
5	"sharingInfo": {
6		"shareUrl": "https://open.spotify.com/artist/5a2EaR3hamoenG9rDuVn8j?si=AqCC3XXqTtK1F7P3BzZm7Q",
7		"shareId": "AqCC3XXqTtK1F7P3BzZm7Q"
8	},
9	"profile": {
10		"name": "Prince",
11		"verified": true,
12		"pinnedItem": {
13			"comment": "Best of Prince",
14			"type": "PLAYLIST",
15			"backgroundImage": {
16				"sources": [
17					{
18						"url": ""
19					}
20				]
21			},
22			"itemV2": {},
23			"item": {
24				"uri": "spotify:playlist:3jXMLVtLsok8PpCWFj8d5l",
25				"name": "Prince: Greatest Hits",
26				"images": {
27					"items": []
28				}
29			}
30		},
31		"biography": {
32			"type": "BIOGRAPHY",
33			"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)."
34		},
35		"externalLinks": {
36			"items": []
37		},
38		"playlistsV2": {
39			"totalCount": 8,
40			"items": []
41		}
42	},
43	"visuals": {
44		"gallery": {
45			"items": []
46		},
47		"avatarImage": {
48			"sources": [
49				{
50					"url": "https://i.scdn.co/image/ab6761610000e5ebeaca358712b3fe4ed9814640",
51					"width": 640,
52					"height": 640
53				},
54				{
55					"url": "https://i.scdn.co/image/ab6761610000f178eaca358712b3fe4ed9814640",
56					"width": 160,
57					"height": 160
58				},
59				{
60					"url": "https://i.scdn.co/image/ab67616100005174eaca358712b3fe4ed9814640",
61					"width": 320,
62					"height": 320
63				}
64			],
65			"extractedColors": {
66				"colorRaw": {
67					"hex": "#535353"
68				}
69			}
70		},
71		"headerImage": {
72			"sources": [
73				{
74					"url": "https://i.scdn.co/image/ab67618600001016da4c8e34df72aa53d798faa3",
75					"width": 2660,
76					"height": 1140
77				}
78			],
79			"extractedColors": {
80				"colorRaw": {
81					"hex": "#535353"
82				}
83			}
84		}
85	},
86	"discography": {
87		"latest": null,
88		"popularReleasesAlbums": {
89			"totalCount": 20,
90			"items": []
91		},
92		"singles": {
93			"totalCount": 28,
94			"items": []
95		},
96		"albums": {
97			"totalCount": 55,
98			"items": []
99		},
100		"compilations": {
101			"totalCount": 4,
102			"items": []
103		},
104		"topTracks": {
105			"items": []
106		}
107	},
108	"stats": {
109		"followers": 7566358,
110		"monthlyListeners": 10755536,
111		"worldRank": 0,
112		"topCities": {
113			"items": []
114		}
115	},
116	"relatedContent": {
117		"appearsOn": {
118			"totalCount": 18,
119			"items": []
120		},
121		"featuringV2": {
122			"totalCount": 8,
123			"items": []
124		},
125		"discoveredOnV2": {
126			"totalCount": 100,
127			"items": []
128		},
129		"relatedArtists": {
130			"totalCount": 40,
131			"items": []
132		}
133	},
134	"goods": {
135		"events": {
136			"userLocation": {
137				"name": "Brisbane"	// Based on IP address
138			},
139			"concerts": {
140				"totalCount": 0,
141				"items": [],
142				"pagingInfo": {
143					"limit": 0
144				}
145			}
146		},
147		"merch": {
148			"items": []
149		}
150	}
151}

Support

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

Cheers!