Melon Chart Scraper 🇰🇷🎵

Scrape Melon (멜론) — Korea's #1 music streaming platform — for real-time charts, song data, and search results. Extract K-pop rankings, song details, lyrics, and album metadata.

No browser needed — uses fast, lightweight HTML parsing. No proxies required.

⚡ Quick Start

Scrape TOP 100 chart

{
    "mode": "top100",
    "maxResults": 100
}

Search for an artist

{
    "mode": "search",
    "keyword": "아이유",
    "maxResults": 20
}

Get chart with full details (lyrics, genre, release date)

{
    "mode": "daily",
    "fetchDetails": true,
    "maxResults": 50
}

🎯 Use Cases

• K-pop Market Research — Track chart performance of artists and songs
• Music Data Analysis — Build datasets for trend analysis and visualization
• Playlist Curation — Discover trending Korean music for playlist creation
• Academic Research — Collect K-pop chart data for music industry studies
• A&R / Label Intelligence — Monitor chart movements and emerging artists
• SEO & Content — Create data-driven K-pop content with real chart data
• Fan Community — Track your favorite artists' chart rankings over time

📥 Input Parameters

Parameter	Type	Default	Description
mode	string	"top100"	Chart type: top100, hot100, daily, weekly, monthly, or search
keyword	string	—	Search keyword (required when mode is search)
fetchDetails	boolean	false	Fetch song detail pages for genre, lyrics, release date
maxResults	integer	100	Maximum tracks to return (1–500)
proxyConfiguration	object	—	Apify Proxy settings (optional)

Chart Modes

Mode	Description	URL
top100	Real-time TOP 100	melon.com/chart/index.htm
hot100	HOT 100	melon.com/chart/hot100/index.htm
daily	Daily chart	melon.com/chart/day/index.htm
weekly	Weekly chart	melon.com/chart/week/index.htm
monthly	Monthly chart	melon.com/chart/month/index.htm
search	Search by keyword	melon.com/search/song/index.htm

📤 Output Fields

Each result contains:

Field	Type	Description
rank	integer	Chart ranking (1–100). Null for search results
songId	string	Melon song ID
title	string	Song title
artist	string	Artist name
albumTitle	string	Album title
albumId	string	Melon album ID
albumImageUrl	string	Album cover image URL
songUrl	string	Direct URL to song detail page
genre	string	Genre (when fetchDetails: true)
releaseDate	string	Release date (when fetchDetails: true)
lyrics	string	Full lyrics (when fetchDetails: true)
flacInfo	string	FLAC quality info (when fetchDetails: true)
chartType	string	Chart type used for this scrape
scrapedAt	string	Scrape timestamp (UTC)

Sample Output

{
    "rank": 1,
    "songId": "601237102",
    "title": "BANG BANG",
    "artist": "IVE (아이브)",
    "albumTitle": "REVIVE+",
    "albumId": "12845274",
    "albumImageUrl": "https://cdnimg.melon.co.kr/cm2/album/images/128/45/274/12845274_20260223113048_500.jpg/melon/resize/120/quality/80/optimize",
    "songUrl": "https://www.melon.com/song/detail.htm?songId=601237102",
    "genre": "댄스",
    "releaseDate": "2026.02.09",
    "lyrics": "It's a new scene It's aggressive...",
    "flacInfo": "Flac 16/24bit",
    "chartType": "top100",
    "scrapedAt": "2026-02-28T04:30:00.000000"
}

💰 Pricing

• $0.50 per 1,000 tracks — Pay only for results
• Detail page fetching included in the price
• No hidden fees or minimum spend

⚙️ Performance

Mode	Speed	Data
fetchDetails: false	~100 tracks/sec	Titles, artists, albums
fetchDetails: true	~3-5 tracks/sec	+ Genre, lyrics, release date

🔧 Technical Details

• Method: Server-side rendered HTML parsing (httpx + BeautifulSoup)
• Rate limiting: Built-in delays to respect Melon's servers
• Proxy: Optional (Melon doesn't block bots by default)
• Language: Python 3.12+
• No browser: Pure HTTP requests — fast and cost-effective

📋 Notes

• Melon is Korea's largest music streaming platform with 28M+ users
• Chart data updates in real-time (TOP100) or periodically (daily/weekly/monthly)
• Song details include Korean lyrics — great for language learning and analysis
• All public data — no authentication required