Spotify Search Tracks

Search Spotify tracks 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 tracks by one or more keywords and extract structured track data in bulk.

🔍 Search tracks by song name, artist name, or any keyword

🎵 Get structured track metadata — content rating, media type, album palette, associations, and visuals

📦 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 track item, the Actor returns:

• Track type, URI, ID, name
• Duration, media type, content rating, playable flag
• Artists list (name, URI)
• Album data (id, uri, name, images)
• Album colors converted to hex (dominant, encore text, contrast palettes)
• Association counts (audio/video)
• 16:9 cover visuals (all available sizes)

🔧 How to use

1. Create a free Apify account.
2. Open Spotify Search Tracks.
3. Enter one or more search queries (e.g. ["alan walker", "faded", "eminem"]).
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 track 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": ["lucid dreams", "shape of you", "blinding lights"],
    "limit": 10,
    "numberOfTopResults": 5
}

⬆️ Output

Each track result is pushed as one dataset item:

{
    "query": "lucid dreams",
    "data": {
        "type": "track",
        "id": "285pBltuF7vW8TeWk8hdRR",
        "uri": "spotify:track:285pBltuF7vW8TeWk8hdRR",
        "name": "Lucid Dreams",
        "duration_ms": 239835,
        "media_type": "AUDIO",
        "content_rating": "EXPLICIT",
        "playable": true,
        "artists": [
            {
                "name": "Juice WRLD",
                "uri": "spotify:artist:4MCBfE4596Uoi2O4DtmEMz"
            }
        ],
        "album": {
            "id": "6tkjU4Umpo79wwkgPMV3nZ",
            "uri": "spotify:album:6tkjU4Umpo79wwkgPMV3nZ",
            "name": "Goodbye & Good Riddance",
            "images": [
                {
                    "width": 640,
                    "height": 640,
                    "url": "https://i.scdn.co/image/ab67616d0000b273f7db43292a6a99b21b51d5b4"
                },
                {
                    "width": 300,
                    "height": 300,
                    "url": "https://i.scdn.co/image/ab67616d00001e02f7db43292a6a99b21b51d5b4"
                },
                {
                    "width": 64,
                    "height": 64,
                    "url": "https://i.scdn.co/image/ab67616d00004851f7db43292a6a99b21b51d5b4"
                }
            ],
            "colors": {
                "dominant": "#1C7FA9",
                "encore_text": "#60C5F8",
                "high_contrast": {
                    "background": "#005781",
                    "background_tinted": "#00335A",
                    "text": "#FFFFFF",
                    "accent": "#FFFFFF",
                    "subdued": "#86D7FF"
                }
            }
        },
        "associations": {
            "audio_count": 0,
            "video_count": 1
        },
        "visuals": {
            "cover_16_9": [
                {
                    "width": 640,
                    "height": 360,
                    "url": "https://image-cdn-ak.spotifycdn.com/image/ab6742d3000052b6c0d31041966e60723eb111d5"
                },
                {
                    "width": 1280,
                    "height": 720,
                    "url": "https://image-cdn-ak.spotifycdn.com/image/ab6742d3000053b6c0d31041966e60723eb111d5"
                }
            ]
        }
    }
}

🔗 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.