Spotify Playlists Scraper 🎵

Extract detailed information about Spotify playlists based on your search keywords. This actor helps you collect comprehensive data about music playlists efficiently and reliably.

🎯 Use Cases

• Music industry research and analysis
• Playlist discovery and curation
• Marketing campaign planning
• Competitive analysis
• Music trend research
• Genre-specific playlist mapping
• Audience insight gathering

✨ Features

• Search multiple keywords
• Get detailed playlist information
• Extract high-quality playlist cover images
• Collect playlist owner details
• Gather playlist metadata

🔢 Output

The actor provides detailed information for each playlist, including:

• Playlist name and description
• Format type
• Cover images with color information
• Owner details
• Spotify URI and direct URL
• Various attributes (status, request ID, etc.)
• Original search keyword

💎 Input Parameters

• keywords (Array): List of keywords to search for playlists
• maxItems (Number): Maximum number of playlists to scrape per keyword

Input Example

A full explanation of an input example in JSON.

{
    "keywords": ["punk"],
    "maxItems": 50
}

Output sample

The results will be wrapped into a dataset which you can always find in the Storage tab. Here's an excerpt from the data you'd get if you apply the input parameters above:

And here is the same data but in JSON. You can choose in which format to download your data: JSON, JSONL, Excel spreadsheet, HTML table, CSV, or XML.

[
	{
		"__typename": "Playlist",
		"attributes": [
			{
				"key": "request_id",
				"value": "ssp~06259bddec3550a5aedaa1664c3de4b0e44d"
			},
			{
				"key": "uri",
				"value": "spotify:user:spotify:playlist:37i9dQZF1DXdRLa2gxBNsq"
			},
			{
				"key": "status",
				"value": "PUBLISHED"
			},
			{
				"key": "isAlgotorial",
				"value": "true"
			},
			{
				"key": "primary_color",
				"value": "#ffffff"
			},
			{
				"key": "autoplay",
				"value": "spotify:playlist:37i9dQZF1DX1o1CavDfr20"
			},
			{
				"key": "correlation-id",
				"value": "ssp~06259bddec3550a5aedaa1664c3de4b0e44d"
			}
		],
		"description": "No, el punk español NO ESTÁ MUERTO. Foto: La Polla Records.",
		"format": "editorial",
		"images": {
			"items": [
				{
					"extractedColors": {
						"colorDark": {
							"hex": "#E01028",
							"isFallback": false
						}
					},
					"sources": [
						{
							"height": null,
							"url": "https://i.scdn.co/image/ab67706f0000000239aaa0e33a6cddeaff1d030a",
							"width": null
						}
					]
				}
			]
		},
		"name": "Punk Español",
		"ownerV2": {
			"__typename": "UserResponseWrapper",
			"data": {
				"__typename": "User",
				"avatar": {
					"sources": [
						{
							"height": 64,
							"url": "https://i.scdn.co/image/ab67757000003b8255c25988a6ac314394d3fbf5",
							"width": 64
						},
						{
							"height": 300,
							"url": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5",
							"width": 300
						}
					]
				},
				"name": "Spotify",
				"uri": "spotify:user:spotify",
				"username": "spotify"
			}
		},
		"uri": "spotify:playlist:37i9dQZF1DXdRLa2gxBNsq",
		"playlistUrl": "https://open.spotify.com/playlist/37i9dQZF1DXdRLa2gxBNsq",
		"keyword": "punk"
	},
	{
		"__typename": "Playlist",
		"attributes": [
			{
				"key": "request_id",
				"value": "ssp~06259a10c2ceb7eeefe8c1fe29e58f8962d8"
			},
			{
				"key": "cloud_artists_uris",
				"value": "spotify:artist:5LfGQac0EIXyAN8aUwmNAQ,spotify:artist:7oPftvlwr6VrsViSDV7fJY,spotify:artist:74XFHRwlV6OrjEM0A2NCMF"
			},
			{
				"key": "correlation-id",
				"value": "ssp~06259a10c2ceb7eeefe8c1fe29e58f8962d8"
			}
		],
		"description": "<a href=spotify:playlist:37i9dQZF1EIXPrpSYA3SWg>The Offspring</a>, <a href=spotify:playlist:37i9dQZF1EIUS4AX2TRHgq>Green Day</a>, <a href=spotify:playlist:37i9dQZF1EIZexEUzyOPQ4>Paramore</a> and more",
		"format": "topic-mix",
		"images": {
			"items": [
				{
					"extractedColors": {
						"colorDark": {
							"hex": "#518077",
							"isFallback": false
						}
					},
					"sources": [
						{
							"height": null,
							"url": "https://seed-mix-image.spotifycdn.com/v6/img/punk/5LfGQac0EIXyAN8aUwmNAQ/en/default",
							"width": null
						}
					]
				}
			]
		},
		"name": "Punk Mix",
		"ownerV2": {
			"__typename": "UserResponseWrapper",
			"data": {
				"__typename": "User",
				"avatar": {
					"sources": [
						{
							"height": 64,
							"url": "https://i.scdn.co/image/ab67757000003b8255c25988a6ac314394d3fbf5",
							"width": 64
						},
						{
							"height": 300,
							"url": "https://i.scdn.co/image/ab6775700000ee8555c25988a6ac314394d3fbf5",
							"width": 300
						}
					]
				},
				"name": "Spotify",
				"uri": "spotify:user:spotify",
				"username": "spotify"
			}
		},
		"uri": "spotify:playlist:37i9dQZF1EQqlvxWrOgFZm",
		"playlistUrl": "https://open.spotify.com/playlist/37i9dQZF1EQqlvxWrOgFZm",
		"keyword": "punk"
	},
    ...
]