Spotify Search Playlists

Search Spotify playlists by keyword. Run multiple queries in a single Actor run. No API key required.

🤔 What can this Actor do?

This Actor lets you search Spotify playlists by one or more keywords and extract structured playlist data in bulk.

🔍 Search playlists by name, theme, mood, or any keyword

📋 Get structured playlist metadata — id, owner profile, image sets, and color palette

📦 Run multiple queries at once — each query produces its own dataset item

🔁 Rotate proxies to avoid rate limiting (optional)

📦 Download results in JSON, CSV, XML, or Excel from the Apify Dataset

🦾 Integrate via API, webhooks, SDKs (Python & Node.js), or connect with Zapier, n8n, Make, and more

✅ What data does this Actor return?

For each playlist item, the Actor returns:

• Playlist type, URI, ID, name, description
• Playlist images in multiple sizes
• Owner profile (name, username, uri, avatar images)
• Playlist color palette (dominant, encore text, and contrast sets in hex)

🔧 How to use

1. Create a free Apify account.
2. Open Spotify Search Playlists.
3. Enter one or more search queries (e.g. ["top hits 2024", "chill vibes", "workout motivation"]).
4. Optionally adjust limit, numberOfTopResults, and proxy settings.
5. Click Save & Start and wait for the results.
6. Download your data in JSON, CSV, XML, Excel, or access it via the Apify API.

⬇️ Input

Field	Type	Description
queries	string[]	Required. List of search keywords. Results are flattened to one playlist per dataset item.
limit	integer	Max results per query (default: 10).
numberOfTopResults	integer	Number of top results to include (default: 5).
proxyConfiguration	object	Optional. Apify Proxy or custom proxy URLs.

Offset is handled internally by the Actor (starts from 0) and is not exposed as input.

Example input

{
    "queries": ["top hits 2024", "chill vibes", "workout motivation"],
    "limit": 10,
    "numberOfTopResults": 5
}

⬆️ Output

Each playlist result is pushed as one dataset item:

{
    "query": "top hits 2024",
    "data": {
        "type": "playlist",
        "id": "3hnkI7OaJS8LBxLNs5RquJ",
        "uri": "spotify:playlist:3hnkI7OaJS8LBxLNs5RquJ",
        "name": "Indo Hits 2000an",
        "description": "Top songs Indonesia 2000an...",
        "images": [
            {
                "width": 640,
                "height": 640,
                "url": "https://mosaic.scdn.co/640/..."
            }
        ],
        "owner": {
            "name": "Pamella Fricylia",
            "username": "21v3bqtbwhcbvanwrevrtk3tq",
            "uri": "spotify:user:21v3bqtbwhcbvanwrevrtk3tq",
            "avatar": [
                {
                    "width": 300,
                    "height": 300,
                    "url": "https://i.scdn.co/image/ab6775700000ee852f1dc405afbe7945f21841a0"
                }
            ]
        },
        "colors": {
            "dominant": "#747A51",
            "encore_text": "#B7C087",
            "high_contrast": {
                "background": "#515721",
                "background_tinted": "#313600",
                "text": "#FFFFFF",
                "accent": "#FFFFFF",
                "subdued": "#CAD399"
            }
        }
    }
}

🔗 Integrations

Connect this Actor with your favorite tools via Apify integrations: Zapier, n8n, Make, Slack, Google Sheets, Google Drive, Airbyte, GitHub, and many more.

Use webhooks to trigger actions automatically when a run finishes.

🦾 Using the Apify API

• Python: apify-client on PyPI
• Node.js: apify-client on NPM

❓ FAQ

Does this require a Spotify account or API key?

No. This Actor works without a Spotify account or API key — authentication tokens are generated automatically per session.

Can I run multiple search queries at once?

Yes. Pass an array to the queries field. Each query runs independently and produces its own dataset item.

Is it legal to scrape Spotify?

This Actor only accesses publicly available Spotify data. Ensure you have a legitimate purpose and consult legal counsel if unsure. See also Apify's blog on the legality of web scraping.