🎵 Spotify Metadata Scraper – APIfy Actor This actor extracts structured metadata from Spotify Track, Album, or Artist pages using the public URL. --- ## 🚀 How It Works Provide a Spotify URL of a track, album, or artist. The actor will detect the type and return structured metadata in JSON format. --- ## 📅 Input ### url (string, required) A valid Spotify URL of one of the following types: * https://open.spotify.com/track/... * https://open.spotify.com/album/... * https://open.spotify.com/artist/... --- ## ✅ Output The output depends on the input URL type. Only one of the following keys will be present in the output JSON: track, artist, or album. --- ### 🎵 Track Example json { "track": { "id": "7KA4W4McWYRpgf0fWsJZWB", "name": "See You Again (feat. Kali Uchis)", "durationMs": 180386, "popularity": 93, "previewUrl": "https://p.scdn.co/mp3-preview/c703198293891e3b276800ea6b187cf7951d3d7d?cid=d8a5ed...", "playCount": 2425737307, "album": { "id": "2nkto6YNI4rUYTLqEwWJ3o", "name": "Flower Boy", "releaseDate": "2017-07-21", "image": "https://i.scdn.co/image/ab67616d0000b2738940ac99f49e44f59e6f7fb3", "url": "https://open.spotify.com/album/2nkto6YNI4rUYTLqEwWJ3o" }, "artists": [ { "id": "4V8LLVI7PbaPR0K2TGSxFF", "name": "Tyler, The Creator", "url": "https://open.spotify.com/artist/4V8LLVI7PbaPR0K2TGSxFF" }, { "id": "1U1el3k54VvEUzo3ybLPlM", "name": "Kali Uchis", "url": "https://open.spotify.com/artist/1U1el3k54VvEUzo3ybLPlM" } ], "externalUrl": "https://open.spotify.com/track/7KA4W4McWYRpgf0fWsJZWB" } } --- ### 👤 Artist Example json { "artist": { "name": "Robonoise", "followers": 291, "genres": [], "popularity": 24, "url": "https://open.spotify.com/artist/7mfdZRvtBIXta6xfFUz3rg", "topTracks": [ { "id": "73T9pkx51ocb0qBZxlr68V", "name": "Echoes", "releaseDate": "2025-01-06", "totalTracks": 1, "url": "https://open.spotify.com/album/73T9pkx51ocb0qBZxlr68V", "image": "https://i.scdn.co/image/ab67616d0000b2732a93436b981953f58f824439" } ] } } --- ### 📁 Album Example json { "album": [ { "id": "1yIz4Y0M9akXGFz4ybSSBO", "name": "Alarm", "durationMs": 160000, "previewUrl": null, "trackNumber": 1 }, { "id": "1OvZ5PTCP98eM2zaJB2QJm", "name": "Dance", "durationMs": 160000, "previewUrl": "https://p.scdn.co/mp3-preview/aa6697bd04a05c18e64bd283cb8eb2b33e335277?cid=...", "trackNumber": 11 } // ...more tracks ] } --- ## 📌 Notes * This actor parses Spotify’s web pages (not using the official Spotify API), so it does not require any authentication. * For tracks, it attempts to scrape estimated play count where available. --- ## 📤 Example Usage (JavaScript) javascript const { Actor } = require('apify'); await Actor.call('your-username/spotify-scraper', { url: 'https://open.spotify.com/track/7KA4W4McWYRpgf0fWsJZWB' }); --- ## 📋 Use Cases * Music metadata enrichment * Playlist analysis tools * Artist monitoring dashboards * Competitor insight for labels or producers --- ## 🛠️ Tech Stack * Apify SDK * Puppeteer for page parsing * JSON-based schema output --- ## 📮 Feedback or Issues? Feel free to open an issue on the Apify platform or fork the actor to customize it further. ---