🎵 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

{
  "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

{
  "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

{
  "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)

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.

---