Spotify

Pricing

Rating

Developer

Actor stats

Categories

Share

🎶 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!