Melon Chart API — RapidAPI Proxy

Cloudflare Worker that proxies Melon Chart Scraper (Apify) for the RapidAPI marketplace.

Access Melon (멜론) — Korea's #1 music streaming platform with 28M+ users. Get real-time K-pop charts, song details, lyrics, and search results.

🚀 Endpoints

GET /chart — Get Chart Rankings

Parameter	Type	Default	Description
type	string	top100	Chart: top100, hot100, daily, weekly, monthly
limit	int	100	Max tracks (1–500). Also accepts maxResults
fetchDetails	bool	false	Include genre, lyrics, release date (slower)

Examples:

GET /chart?type=top100&limit=50
GET /chart?type=daily&fetchDetails=true&limit=20
GET /chart?type=weekly

Chart Types

Type	Description	Update Frequency
top100	Real-time TOP 100	Real-time
hot100	HOT 100	Real-time
daily	Daily chart	Daily
weekly	Weekly chart	Weekly
monthly	Monthly chart	Monthly

GET /search — Search Songs

Parameter	Type	Default	Description
keyword	string	required	Search keyword (also accepts query or q)
limit	int	100	Max results (1–500)
fetchDetails	bool	false	Include genre, lyrics, release date

Examples:

GET /search?keyword=아이유&limit=20
GET /search?keyword=BTS&fetchDetails=true

GET /health — Health Check

Returns service status, available endpoints, and chart types.

📤 Response Format

{
  "success": true,
  "count": 100,
  "data": [
    {
      "rank": 1,
      "songId": "601237102",
      "title": "BANG BANG",
      "artist": "IVE (아이브)",
      "albumTitle": "REVIVE+",
      "albumId": "12845274",
      "albumImageUrl": "https://cdnimg.melon.co.kr/...",
      "songUrl": "https://www.melon.com/song/detail.htm?songId=601237102",
      "chartType": "top100",
      "scrapedAt": "2026-03-21T04:30:00.000000"
    }
  ]
}

With fetchDetails=true

Additional fields: genre, releaseDate, lyrics, flacInfo

⚙️ Setup

1. Install dependencies

npm install

2. Set secrets

wrangler secret put APIFY_TOKEN
wrangler secret put RAPIDAPI_PROXY_SECRET

3. Deploy

npm run deploy

4. Register on RapidAPI

1. Go to RapidAPI Provider Dashboard
2. Create API → paste Worker URL
3. Define /chart and /search endpoints
4. Set pricing

💰 Pricing Guide (RapidAPI)

Tier	Monthly	Requests	Rate Limit
Basic (Free)	$0	100/month	10/min
Pro	$9.99	5,000/month	30/min
Ultra	$29.99	25,000/month	100/min
Mega	$99.99	Unlimited	300/min

RapidAPI takes 25% commission. Factor in Apify compute costs (~$0.50/1000 tracks).

📄 License

MIT