TopChart Service
Spotify daily chart aggregation microservice powering the Musiva WebPlayer discovery dashboard.
Official Service: https://topchart.musiva.app/
TopChart is an internal microservice dedicated to scraping, parsing, and caching official Spotify Top Chart data. It provides clean JSON endpoints that feed the discovery widgets on the Musiva WebPlayer dashboard.
Chart Categories
TopChart currently processes and serves two primary chart datasets:
1. Top Track Daily (Global)
- Contains the globally ranked top tracks for the day.
- Updated daily based on Spotify's official streaming counts.
- Powers the hero chart carousel on the WebPlayer homepage.
2. Top Country (Regional)
- Provides daily top tracks segmented by individual country codes (e.g.,
US,ID,GB,JP). - Enables localized music discovery, allowing users to view trending songs in their specific region.
Division of Responsibilities: TopChart vs. Last.fm
TopChart is specifically responsible for Spotify streaming charts. Other rich music metadata displayed across the WebPlayer dashboard is intentionally sourced from Last.fm:
| Feature / Data Point | Provider | Purpose |
|---|---|---|
| Top Track Daily (Global) | TopChart | Real-time global Spotify streaming leaderboard |
| Top Country Tracks | TopChart | Regional music chart leaderboards |
| Top Artists | Last.fm | Global artist listener statistics & bio |
| Top Albums | Last.fm | Trending album releases & tracklists |
| Music Recommendations | Last.fm | Collaborative filtering & genre similarity |
This separation ensures that Spotify scraping operations remain isolated. If Spotify modifies its chart markup or rate limits the scraper, Last.fm artist statistics and recommendations remain fully accessible to users.