OrbTop

Kworb LATAM Spotify Daily & Weekly Charts Scraper

SOCIAL MEDIA
Try on Apify

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.

Try on Apify