통합 음원차트 API (Korean Music · K-pop Chart) – 멜론·지니·벅스·FLO·VIBE 올킬

멜론 · 지니 · 벅스 · FLO · 바이브(VIBE)의 실시간 · 일간 · 주간 차트를 한 번에 가져와 하나의 표로 합칩니다. 곡마다 플랫폼별 순위, 통합 순위와 점수, 몇 개 플랫폼에 올랐는지, 올킬 여부가 한 행에 나옵니다. 플랫폼별 원본 행도 같은 열 구성(source 칸으로 구분)으로 함께 받을 수 있고, 검색어 하나로 5개 플랫폼을 동시에 검색해 플랫폼별 곡 ID를 서로 맞춰 줍니다. 로그인도, 브라우저도 필요 없습니다.

💰 가격	결과 행 $0.25 / 1,000행 (약 350원). 5개 플랫폼 실시간 TOP100 통합 순위 ≈ 170행 ≈ $0.04 (약 60원)
🎁 무료	매달 결과 500행 무료
⚡ 속도	5개 플랫폼 차트 동시 수집: 실시간 TOP100 = 약 5초, 일간 최대 순위(950곡) = 약 7초
🔓 로그인	필요 없음 (각 플랫폼에서 로그아웃 상태로 보이는 공개 차트·검색 결과만)

결과 미리보기: 실제 실행 결과 (2026-11-02, 주간 차트, outputMode: "unified"). 1위 NEON은 멜론·지니·벅스·FLO 주간 1위라 isAllKill: true입니다.

통합 순위	곡	아티스트	멜론	지니	벅스	FLO	플랫폼 수	올킬
1	NEON	A2O, A2O LITE	1	1	1	1	4	✅
2	퇴사할게여 (Narr. 기안84)	소연 (SOYEON)	2	2	5	2	4	–
3	꿈꾸던 어른이 되었나요?	머무르	3	3	2	4	4	–
4	LOVE ATTACK	RESCENE (리센느)	4	4	6	3	4	–
5	갑자기	아이오아이 (I.O.I)	6	5	10	5	4	–

바로 실행: Try for free를 누르고 기본 입력 그대로 Start → 약 5초 뒤 5개 플랫폼 실시간 통합 순위가 나옵니다. 곡마다 플랫폼별 곡 ID·링크, ISRC, 발매일, 커버도 함께 들어갑니다 (전체 열은 아래 출력 예시).

비공식(unofficial) 도구입니다. Not affiliated with, endorsed or sponsored by Melon, Genie, Bugs, FLO, NAVER VIBE or their operators.

🎵 무엇을 가져오나요?

• 통합 차트 (곡당 1행): melonRank · genieRank · bugsRank · floRank · vibeRank, 플랫폼별 순위 변동, unifiedRank(통합 순위), unifiedScore(통합 점수), platformCount(오른 플랫폼 수), bestRank · averageRank, numberOneCount(1위 플랫폼 수), isAllKill(올킬: 모든 플랫폼 1위), 멜론 좋아요 수, FLO 차트 점수, ISRC, 발매일, 커버, 플랫폼별 곡 ID와 링크.
• 플랫폼별 행: 5개 플랫폼이 같은 열 구성 — source, 차트 이름·기준 시각, rank, rankChange(+상승 / -하락 / 0), rankStatus(up · down · same · new), 곡·아티스트(ID 포함)·앨범, 커버, 곡 링크, 그리고 플랫폼 고유 값(멜론 likes, FLO chartScore·발매일, VIBE isrc·발매일).
• 차트 종류: 실시간(멜론 TOP100 · 지니 TOP200 · 벅스 실시간 TOP100 · FLO 차트 · VIBE 오늘 Top 100), 일간(멜론 · 지니 TOP200 · 벅스 · FLO TOP250 · VIBE 300위), 주간(멜론 · 지니 · 벅스 · FLO).
• 5개 플랫폼 동시 검색: 곡명·아티스트로 검색해, 같은 곡을 하나의 통합 행으로 묶고 songIds(예: {"melon": "603382333", "genie": "117256249", …})를 돌려줍니다. 플랫폼 간 곡 ID 매칭·카탈로그 정리에 바로 쓸 수 있습니다.

💡 왜 이 액터인가요?

• 5개 플랫폼을 한 번에: Apify 스토어의 다른 K-pop 차트 도구는 멜론·지니·벅스 실시간 TOP100만 다루고, FLO·VIBE는 없습니다. 이 액터는 5개 플랫폼의 실시간·일간·주간을 모두 다룹니다.
• 이미 합쳐진 통합 순위: 플랫폼별 결과를 따로 받아 엑셀에서 맞출 필요가 없습니다. 같은 곡을 곡명 + 아티스트로 자동으로 묶습니다 ((Feat. …), IVE (아이브) / IVE(아이브) 같은 표기 차이도 처리).
• 올킬 체크 자동화: isAllKill, numberOneCount, platformCount로 "올킬", "퍼펙트 올킬 후보", "5개 플랫폼 TOP100 동시 진입"을 한 번에 확인합니다.
• 저렴: $0.25 / 1,000행, 매달 500행 무료. 다른 K-pop 차트 피드($2 / 1,000행, 3개 플랫폼)보다 8배 저렴합니다. 통합 순위만 받으면(outputMode: "unified") 곡당 1행만 과금됩니다.
• 믿을 수 있는 데이터: K-Data Lab의 멜론·지니·벅스·FLO·VIBE 개별 액터와 같은 수집 코드를 씁니다. 테스트에서 5개 플랫폼 TOP20이 개별 액터 결과와 100% 일치했습니다. 플랫폼 하나가 실패해도 나머지 결과는 정상으로 나오고, 실패한 플랫폼은 RUN_SUMMARY에 이유와 함께 남습니다.

📥 입력 예시

5개 플랫폼 실시간 차트 → 통합 순위 + 플랫폼별 행 (기본값):

{ "chartType": "realtime" }

일간 차트, 플랫폼마다 가능한 최대 순위까지, 통합 순위만:

{ "chartType": "daily", "maxRank": 300, "outputMode": "unified" }

멜론·지니·벅스만 (3사 올킬 체크):

{ "chartType": "realtime", "platforms": ["melon", "genie", "bugs"], "maxRank": 10, "outputMode": "unified" }

5개 플랫폼 동시 검색 (곡 ID 매칭):

{ "chartType": "none", "searchKeywords": ["아이유", "aespa"], "maxSearchResults": 50 }

입력	설명
chartType	realtime(실시간) · daily(일간) · weekly(주간, VIBE 제외) · none(검색만)
platforms	melon · genie · bugs · flo · vibe (기본값: 5개 전부)
maxRank	플랫폼별 최대 순위 1~300 (기본 100). 상한: 멜론·벅스 100, 지니 200, FLO 100(일간 250), VIBE 300
searchKeywords, maxSearchResults	5개 플랫폼 동시 검색어와 검색어·플랫폼별 곡 수 (기본 30, 최대 500)
outputMode	both(통합 + 플랫폼별, 기본) · unified(곡당 1행) · perPlatform(플랫폼별 행만)

📤 출력 예시

통합 실시간 차트 1위 (실제 실행 결과, 2026-11-01 12시):

{
  "type": "unified",
  "mode": "chart",
  "source": "unified",
  "chartType": "realtime",
  "chartName": "통합 실시간 차트 (멜론·지니·벅스·FLO·VIBE)",
  "unifiedRank": 1,
  "unifiedScore": 494,
  "platformCount": 5,
  "platforms": ["melon", "genie", "bugs", "flo", "vibe"],
  "bestRank": 1,
  "averageRank": 2.2,
  "numberOneCount": 4,
  "isAllKill": false,
  "title": "NEON",
  "artist": "A2O, A2O LITE",
  "albumTitle": "NEON",
  "releaseDate": "2026-10-13",
  "isrc": "KRMIM2655904",
  "melonRank": 1, "genieRank": 1, "bugsRank": 1, "floRank": 7, "vibeRank": 1,
  "melonRankChange": 0, "genieRankChange": 0, "bugsRankChange": 0, "floRankChange": 0, "vibeRankChange": 0,
  "melonLikes": 60549,
  "floChartScore": 121091,
  "songIds": { "melon": "603382333", "genie": "117256249", "bugs": "6511885", "flo": "611656860", "vibe": "108385046" },
  "songUrls": { "melon": "https://www.melon.com/song/detail.htm?songId=603382333", "vibe": "https://vibe.naver.com/track/108385046", "…": "…" },
  "imageUrl": "https://cdnimg.melon.co.kr/cm2/album/images/146/44/795/14644795_20261012141441_500.jpg",
  "scrapedAt": "2026-11-01T03:08:50+00:00"
}

플랫폼별 행 (FLO 차트 1위):

{
  "type": "song", "mode": "chart", "source": "flo", "sourceName": "FLO", "chartType": "realtime",
  "chartName": "FLO 차트 TOP100 (최근 24시간, 매시 갱신)", "chartPeriod": "12시 기준", "chartDate": "2026-11-01T12:59:59+09:00",
  "rank": 1, "rankChange": 0, "rankStatus": "same", "isNew": false, "unifiedRank": 32,
  "songId": "568152509", "title": "이 밤을 빌려 말해요", "artist": "PLAVE", "artistId": "406705114",
  "albumId": "447921948", "releaseDate": "2025-12-29", "chartScore": 154729,
  "songUrl": "https://www.music-flo.com/detail/track/568152509/details"
}

같은 날 같은 시각에도 1위가 플랫폼마다 다를 수 있습니다 (FLO는 최근 24시간 집계). 그래서 통합 점수는 순위가 아니라 플랫폼마다 최대 100점(1위 = 100점, N위까지 받았다면 마지막 순위 = 100/N점)을 더해 계산합니다.

실행이 끝나면 키-값 저장소의 RUN_SUMMARY에 플랫폼별 결과(OK · NOT_AVAILABLE · NO_RESULTS · ERROR), 차트 기준 시각, 올킬 곡, 이번 달 남은 무료 분량, 요청 수가 남습니다. 콘솔의 Output 탭에서 통합 순위 · 플랫폼별 · 검색 매칭 보기를 고를 수 있습니다.

💰 가격 (Pay per event)

이벤트	가격	무료 (매달)
결과 행 (통합 곡 1행 또는 플랫폼별 곡 1행)	$0.25 / 1,000행 (약 350원)	500행
실행 시작	$0.005 / 실행 (약 7원)	–

예: 5개 플랫폼 실시간 TOP100을 매시간 통합 순위만(unified, 약 170행) 한 달 모으면 ≈ 122,000행 ≈ $30 (약 42,000원) + 시작 $3.6. 하루 한 번 일간 통합 순위(약 450행)는 한 달 ≈ $3.4 (약 4,700원). Apify 등급(Bronze · Silver · Gold)에 따라 행 가격은 최대 $0.15 / 1,000행까지 내려갑니다. 실행 옵션의 최대 비용(Max cost)을 정하면 그 금액에서 깨끗하게 멈춥니다 (통합 행이 먼저 저장됩니다).

🎯 이런 분께 좋아요

• 기획사·A&R·팬 커뮤니티: 신곡 발매 후 5개 플랫폼 순위와 올킬 여부를 매시간 자동 기록.
• 음악 미디어·뉴스: "오늘의 통합 차트", "올킬 달성" 기사·카드뉴스용 표를 한 번에.
• 마케팅·광고: 플랫폼마다 다른 청취층(멜론 vs FLO vs VIBE)의 반응을 한 표에서 비교.
• 음악 데이터 분석: 플랫폼별 점유·순위 편차, TOP100 동시 진입 곡 수 같은 지표를 매일 쌓기.
• 카탈로그·저작권 관리: 검색으로 같은 곡의 멜론·지니·벅스·FLO·VIBE 곡 ID와 ISRC를 한 번에 매칭.
• AI 에이전트·챗봇: "지금 올킬 곡 있어?", "NEON 플랫폼별 순위는?" 같은 질문에 답하기 (Apify MCP).

🔌 API · 연동

curl -X POST "https://api.apify.com/v2/acts/k-data-lab~korean-music-chart-scraper/run-sync-get-dataset-items?token=<YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"chartType":"realtime","maxRank":10,"outputMode":"unified"}'

from apify_client import ApifyClient

client = ApifyClient("<YOUR_TOKEN>")
run = client.actor("k-data-lab/korean-music-chart-scraper").call(run_input={"chartType": "realtime", "outputMode": "unified"})
for song in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(song["unifiedRank"], song["title"], song["artist"], song["melonRank"], song["genieRank"], song["isAllKill"])

Google Sheets, Make, n8n, Zapier, Slack 연동과 웹훅도 Apify 콘솔의 Integrations 탭에서 바로 연결됩니다. 매시·매일 수집은 Schedules에서 설정하세요.

🤖 AI 에이전트에서 쓰기 (Use it from AI agents · MCP)

Give Claude, ChatGPT, Cursor, VS Code or n8n a ready-made korean-music-chart-scraper tool through Apify's MCP server: the agent reads the input schema, runs this actor and gets the dataset back. AI 에이전트가 입력 항목을 읽고 직접 실행해 결과를 받아 옵니다.

• 이 액터만 (this actor only): https://mcp.apify.com?tools=actors,docs,k-data-lab/korean-music-chart-scraper
• K-chart 6종 묶음 (K-chart bundle): https://mcp.apify.com?tools=actors,docs,k-data-lab/melon-scraper,k-data-lab/genie-scraper,k-data-lab/bugs-scraper,k-data-lab/flo-scraper,k-data-lab/vibe-scraper,k-data-lab/korean-music-chart-scraper

Claude Code

$claude mcp add --transport http apify "https://mcp.apify.com?tools=actors,docs,k-data-lab/korean-music-chart-scraper"

Claude Desktop: Settings → Connectors → Add custom connector, paste the same URL.

Cursor / VS Code (.cursor/mcp.json; in .vscode/mcp.json use "servers" and add "type": "http")

{"mcpServers": {"apify": {
  "url": "https://mcp.apify.com?tools=actors,docs,k-data-lab/korean-music-chart-scraper",
  "headers": {"Authorization": "Bearer <YOUR_APIFY_TOKEN>"}
}}}

Try asking / 이렇게 물어보세요

• "Which songs are all-killing the Korean charts right now? Show their rank on Melon, Genie, Bugs, FLO and VIBE."
• "Get this week's weekly charts and list the top 10 songs by average rank across platforms."
• "Search all five Korean music platforms for aespa and give me each song's ID and link per platform."
• "지금 실시간 음원차트 올킬한 곡 있어? 플랫폼별 순위 같이 보여줘."

❓ 자주 묻는 질문

같은 곡은 어떻게 묶나요? 곡명(대소문자·띄어쓰기·기호 무시, 필요하면 (Feat. …) 같은 괄호 부분 제외)이 같고 아티스트 이름이 하나 이상 겹치면 같은 곡으로 봅니다. IVE (아이브), IVE(아이브), A2O & A2O LITE, A2O LITE, A2O 같은 표기 차이를 처리하고, 한 플랫폼의 두 곡이 한 행으로 합쳐지지는 않습니다. 테스트에서 5개 플랫폼 실시간 TOP100(500행)의 같은 곡 중 놓친 짝은 없었습니다.

올킬(isAllKill)의 기준은? 이번 실행에서 차트를 돌려준 모든 플랫폼(2개 이상)에서 1위면 true입니다. 멜론·지니·벅스만 골라 실행하면 3사 올킬, 5개를 고르면 5개 플랫폼 올킬입니다. 업계에서 말하는 "퍼펙트 올킬"(일간·주간·실시간 모두 1위 등)은 여러 차트 종류를 실행해 numberOneCount로 직접 판단하세요.

VIBE 실시간 차트가 왜 일간인가요? VIBE에는 실시간 종합 차트가 없고 매일 아침 갱신되는 "오늘 Top 100"이 종합 차트입니다. 그래서 실시간에도 오늘 Top 100을 쓰고, 주간에는 VIBE가 빠집니다 (RUN_SUMMARY에 NOT_AVAILABLE로 표시).

차트 기준 시각이 플랫폼마다 달라요. 플랫폼마다 갱신 시각이 다릅니다 (예: 2026-11-01 12시 실행에서 멜론 일간은 10.30, 지니·벅스 일간은 10.31 차트였고, FLO 일간은 최근 7일 집계입니다). 각 행의 chartPeriod·chartDate에 플랫폼이 표시한 기준이 그대로 들어갑니다.

지난 날짜 차트, 장르 차트, 곡 상세(크레딧·재생수)는요? 이 액터는 5개 플랫폼을 같은 기준으로 비교하는 데 집중합니다. 지난 차트·장르 차트·곡 상세는 개별 액터를 쓰세요: 멜론(좋아요·장르 차트), 지니(재생수·청취자수), 벅스(지난 차트·크레딧), FLO(차트 점수·인기 지수), VIBE(2008년~ 지난 차트·ISRC).

검색 결과의 통합 행은 어떻게 정렬되나요? 각 플랫폼 검색 결과의 순서(정확도순)를 차트 순위처럼 점수로 더해 정렬합니다. 여러 플랫폼에서 상위에 나온 곡이 위로 옵니다.

가사도 가져오나요? 아니요. 가사는 저작권이 있는 콘텐츠라 넣지 않습니다.

결과가 비어 있으면 요금이 나가나요? 결과 행이 없으면 행 요금은 없습니다 (실행 시작 요금만). 검색 결과가 없는 플랫폼은 NO_RESULTS로 표시되고 실행은 정상 종료됩니다. 모든 플랫폼에 접속하지 못하면 실행이 실패로 끝나고 이유가 상태 메시지에 나옵니다.

프록시가 필요한가요? 보통 필요 없습니다. 플랫폼이 요청을 거절하면 자동으로 Apify 프록시로 다시 시도합니다.

개인정보·이용 범위는? 각 플랫폼에 공개된 차트·검색 결과의 곡 정보만 가져옵니다. 회원 정보, 플레이리스트, 가사, 댓글은 가져오지 않습니다. 플랫폼마다 동시 접속 3개 이하로 천천히 요청합니다. 수집한 데이터는 각 플랫폼 이용약관과 저작권법을 지켜 사용하시고, AI 모델 학습에는 쓰지 마세요. 비공식 도구이며 각 플랫폼 운영사와 관계가 없습니다.

🧰 K-Data Lab의 다른 액터 (More from K-Data Lab)

• 멜론 차트·곡·앨범 스크래퍼 (Melon Chart API): 멜론 TOP100·HOT100·장르 차트와 좋아요 수
• 지니뮤직 차트·곡·앨범 스크래퍼 (Genie Music Chart API): 지니 TOP200과 곡별 재생수·청취자수
• 벅스 차트·곡·앨범 스크래퍼 (Bugs Music Chart API): 벅스 TOP100·장르 29개·지난 차트와 좋아요·크레딧
• FLO 차트·곡·앨범 스크래퍼 (FLO Music Chart API): FLO 차트·일간 TOP250과 차트 점수·인기 지수
• 바이브 차트·곡·앨범 스크래퍼 (NAVER VIBE Music Chart API): VIBE TOP300·성·연령별 차트·2008년~ 지난 차트·ISRC
• Amazon ASIN Rating & Review Count Scraper: 아마존 ASIN별 별점·리뷰 수·별점 분포·BSR, 19개 마켓, 로그인 불필요
• Amazon Seller Central Review Scraper: 셀러 센트럴(브랜드 레지스트리)의 내 브랜드 리뷰 전체 수집·모니터링, 직접 로그인
• Google Play Scraper API: 구글 플레이 앱 정보와 리뷰, 국가별, 로그인 불필요
• Agoda Scraper: 아고다 호텔 가격, 객실 요금, 리뷰
• Google Ads Transparency & Ad Library Scraper: 경쟁사가 집행하는 구글 광고 전체

💬 문의

빠진 필드, 잘못 묶인 곡, 틀린 값이 있으면 Issues 탭에 남겨 주세요. 당일에 답변드립니다.

---

English summary

Korean Music Charts API (Melon, Genie, Bugs, FLO, VIBE): one run fetches the realtime, daily or weekly overall chart from all five Korean streaming platforms at once and merges them into one unified ranking. Each song gets one row with its Melon / Genie / Bugs / FLO / VIBE rank and rank change, a cross-platform score and unified rank, the number of platforms it charts on, the number of #1s, an all-kill flag (#1 on every platform), Melon like count, FLO chart score, ISRC and every platform's song ID and URL. Platform rows come in one normalized column set with a source field. Keyword search runs on all five platforms and matches the same song's IDs across platforms. No login, no browser; JSON/CSV/Excel or API. $0.25 per 1,000 rows, 500 rows free every month. Unofficial, not affiliated with Melon, Genie, Bugs, FLO or NAVER VIBE. No lyrics, no user data.

Quick start (English): run the prefilled input, or send {"chartType": "realtime", "outputMode": "unified"} for one row per song, {"chartType": "daily", "platforms": ["melon", "genie", "bugs"], "maxRank": 10, "outputMode": "unified"} for a Melon × Genie × Bugs all-kill check, or {"chartType": "none", "searchKeywords": ["NewJeans"]} to match one song's IDs across all five platforms. chartType: realtime · daily · weekly (no VIBE) · none. outputMode: both · unified · perPlatform. Field names in the output are English.

Tags: korean music chart api, kpop chart, k-pop chart data, melon chart api, korean streaming charts, kpop chart api, k-pop all-kill, melon genie bugs flo vibe, 통합 음원차트, 음원 차트 올킬, 실시간 차트, 멜론 차트, 지니 차트, 벅스 차트, 플로 차트, 바이브 차트, 케이팝 차트