Spotify Search Albums

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

🔍 Search albums by title, artist name, or any keyword

💿 Get structured album metadata — type, release year, 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 album item, the Actor returns:

• Album type, URI, ID, name
• Album type label, release year, playable status, pre-release status
• Artists list (name, URI)
• Album images in multiple sizes
• Album colors converted to hex (dominant, encore text, contrast palettes)

🔧 How to use

1. Create a free Apify account.
2. Open Spotify Search Albums.
3. Enter one or more search queries (e.g. ["different world alan walker", "x coldplay"]).
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 album 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": ["different world alan walker", "x coldplay", "midnights taylor swift"],
    "limit": 10,
    "numberOfTopResults": 5
}

⬆️ Output

Each album result is pushed as one dataset item:

{
    "query": "different world alan walker",
    "data": {
        "type": "album",
        "id": "1vLYpcbwwGVClagTen3lXN",
        "uri": "spotify:album:1vLYpcbwwGVClagTen3lXN",
        "name": "2001x",
        "album_type": "SINGLE",
        "year": 2026,
        "playable": true,
        "pre_release": false,
        "artists": [
            {
                "name": "Adrian Khalif",
                "uri": "spotify:artist:6X28gNASnalAWseUA8uI4X"
            }
        ],
        "images": [
            {
                "width": 640,
                "height": 640,
                "url": "https://i.scdn.co/image/ab67616d0000b273e7cecaed4e0dfbb8acfd371e"
            },
            {
                "width": 300,
                "height": 300,
                "url": "https://i.scdn.co/image/ab67616d00001e02e7cecaed4e0dfbb8acfd371e"
            },
            {
                "width": 64,
                "height": 64,
                "url": "https://i.scdn.co/image/ab67616d00004851e7cecaed4e0dfbb8acfd371e"
            }
        ],
        "colors": {
            "dominant": "#383038",
            "encore_text": "#C2B8C2",
            "high_contrast": {
                "background": "#383038",
                "background_tinted": "#5A515A",
                "text": "#FFFFFF",
                "accent": "#FFFFFF",
                "subdued": "#D5CAD4"
            }
        }
    }
}

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