# Changelog of Spotify Viral Hits and Top Songs (`gitlab/spotify-viral-charts-scraper`) Actor

- **URL**: https://apify.com/gitlab/spotify-viral-charts-scraper/changelog.md
- **Full Actor documentation**: https://apify.com/gitlab/spotify-viral-charts-scraper.md

## Changelog — spotify-viral-charts-scraper

### \[1.0.0] — 2025-05-23

#### Added

- Initial release — scrape Spotify Viral 50 and Top 50 chart playlists by country
- Viral 50 uses known playlist IDs per country (US, GB, DE, FR, BR, JP, AU, CA, MX, Global)
- Top 50 uses corresponding country Top 50 playlist IDs
- Returns ranked tracks with chart position (1–50), popularity, duration, explicit flag, addedAt
- `country` and `chartType` fields on each record for multi-chart batch analysis
- OAuth2 client credentials flow with auto token refresh
- Rate-limit retry with `Retry-After` back-off
- Dataset views and schema (`validate-datasets.js`)