Kworb LATAM Spotify Daily & Weekly Charts Scraper

Scrapes daily and weekly Spotify charts for 7 Latin American countries — Brazil, Mexico, Argentina, Chile, Colombia, Peru, and Uruguay — from kworb.net. Returns ranked tracks with stream counts, peak positions, days on chart, and Spotify track IDs. Each run covers up to 14 pages (7 countries × 2 chart periods) and returns up to 200 rows per page.

Spotify killed its public charts API. kworb.net is what remains — the de facto source for per-country daily and weekly Spotify rankings, used by A&R teams, artist managers, and music distributors across the region.

What you get

One row per ranked track, per country, per chart type. Every row includes the chart position, how it moved, how long it's been there, the streams that day (or week), 7-day totals for daily charts, and cumulative all-time streams in that market. The Spotify track ID comes with each record, which means you can join directly to your own catalog data without a second lookup.

Input

Parameter	Type	Description	Default
countryCodes	array	Country codes to scrape: BR, MX, AR, CL, CO, PE, UY	["BR", "MX"]
chartTypes	array	Chart periods: daily, weekly, or both	["daily"]
maxItems	integer	Max rows to return per run (0 = no limit)	0

Set maxItems to a small number when testing. A full run across all 7 countries × both chart types returns up to 2,800 rows.

Output schema

Field	Type	Description
countryCode	string	ISO country code (BR, MX, AR, CL, CO, PE, UY)
chartType	string	Chart period: daily or weekly
chartDate	string	Date of the chart snapshot (YYYY-MM-DD)
rank	integer	Chart position (1–200)
rankChange	integer	Position change vs prior period. Positive = moved up. null for new/re-entry.
isNew	boolean	True if this is the track's first appearance on this chart
isReentry	boolean	True if the track re-entered after dropping off
peakPosition	integer	Highest chart position ever reached in this market
peakTimes	integer	Number of times the track reached its peak position
daysOnChart	integer	Total days (or weeks) on this chart
trackTitle	string	Track title as shown on kworb.net
artistName	string	Primary artist name
artistUrlKworb	string	kworb.net artist page URL
trackUrlKworb	string	kworb.net track detail URL
trackUrlSpotify	string	Spotify open URL for the track
trackIdSpotify	string	Spotify track ID
streamsTotal	integer	Cumulative all-time streams in this market
streamsPeriod	integer	Streams during the chart period (daily or weekly)
streams7Day	integer	7-day stream count (daily charts only)
streams7DayChange	integer	Change in 7-day streams vs prior period (daily charts only)
scrapedAt	string	ISO-8601 timestamp of the scrape

Example output

{
  "countryCode": "BR",
  "chartType": "daily",
  "chartDate": "2026-05-30",
  "rank": 1,
  "rankChange": 0,
  "isNew": false,
  "isReentry": false,
  "peakPosition": 1,
  "peakTimes": 27,
  "daysOnChart": 253,
  "trackTitle": "Eu Te Seguro - Ao Vivo",
  "artistName": "Panda",
  "artistUrlKworb": "https://kworb.net/spotify/artist/5qIpstBGrGteJZg1xIvbiz.html",
  "trackUrlKworb": "https://kworb.net/spotify/track/4V2rUOmaevK0C1bKAkeFf5.html",
  "trackUrlSpotify": "https://open.spotify.com/track/4V2rUOmaevK0C1bKAkeFf5",
  "trackIdSpotify": "4V2rUOmaevK0C1bKAkeFf5",
  "streamsTotal": 208255007,
  "streamsPeriod": 1459815,
  "streams7Day": 7578748,
  "streams7DayChange": 285365,
  "scrapedAt": "2026-06-01T14:59:47.596Z"
}

Pricing

Pay per result. No fixed monthly fee. Costs scale with what you pull — scraping a single country's daily chart costs a fraction of a full 7-country sweep.

Notes

• Source: kworb.net, updated daily. Data reflects what Spotify reports to kworb — there may be a 24–48 hour lag on some markets.
• Rate limiting: The scraper runs at a polite pace to avoid overwhelming the source. A full 14-URL run typically completes in under two minutes.
• Weekly charts: The streams7Day and streams7DayChange fields are null on weekly chart rows — those columns don't exist on the weekly chart pages.
• New and re-entry tracks: When a track is brand new to the chart, rankChange is null and isNew is true. Re-entries set isReentry: true.

---

Need the global chart or US/UK charts? This actor focuses on LATAM. For other regions, check the Apify store.