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!