# 멜론 차트·곡·앨범 스크래퍼 (Melon Chart API) – 좋아요 수 (`k-data-lab/melon-scraper`) Actor

Get Melon (멜론) chart data: realtime TOP100, HOT100, daily, weekly, monthly and genre charts, past charts, song search, songwriter credits, album ratings and artist fans, with like counts. Korean music and K-pop chart API, no login. $0.25/1K songs, 500 free monthly. 멜론 차트 API.

- **URL**: https://apify.com/k-data-lab/melon-scraper.md
- **Developed by:** [K-Data Lab](https://apify.com/k-data-lab) (community)
- **Categories:** Social media, AI
- **Features:** Limited permissions
- **Stats:** 2 total users, 0 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.15 / 1,000 곡 (song)s

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Melon Chart Scraper API (멜론) – K-pop & Korean Music Chart Data, No Login

**Get Melon chart data as JSON, CSV or Excel in about 5 seconds.** Melon (멜론) is Korea's #1 music streaming service. This actor returns the realtime TOP100, HOT100, daily, weekly, monthly and 26 genre charts, plus past weekly and monthly charts, with a **like count for every song**. It also returns song search results, songwriter credits, album ratings and artist fan counts.

| | |
|---|---|
| 🎁 **Your first run** | Click **Try for free**, then **Start**. The prefilled TOP100 returns 100 songs from your 500 free songs. The only charge is the $0.005 run start, which Apify's free monthly credit covers |
| 💰 **Price** | **$0.25 per 1,000 songs**, like counts included. Song details +$0.10 per 1,000, albums and artists $1 per 1,000 |
| 🔁 **Free every month** | 500 songs, 100 song details, 20 albums, 20 artists |
| 🔓 **Login** | None. No cookies, no browser, no proxy to set up |

**Example result** (realtime TOP100, real run):

| rank | rankStatus | title | artist | likes |
|---|---|---|---|---|
| 1 | same | NEON | A2O, A2O LITE | 59,026 |

#### What do you want to get?

| Task | Input |
|---|---|
| Melon TOP100 chart right now | `{"charts":["realtime"]}` |
| Top 10 only, the smallest test | `{"charts":["realtime"],"maxResults":10}` |
| Latest weekly ballad chart | `{"charts":["week"],"genres":["GN0100"]}` |
| A past chart (the week of 2025-03-12) | `{"charts":["week"],"chartDate":"2025-03-12"}` |
| Daily chart with songwriters, composers and release dates | `{"charts":["day"],"includeSongDetails":true}` |
| Search songs by artist or title | `{"searchKeywords":["NewJeans"],"maxResults":50}` |
| An artist's profile, fans and most popular songs | `{"artists":["261143"],"artistSongOrder":"popular"}` |
| Album rating, likes and tracklist | `{"albums":["14535765"]}` |

Every field has an English description, and rows include `chartNameEn` and `genreNameEn`. Song, artist and album names stay as Melon shows them, usually in Korean.

**AI agents (Claude, ChatGPT, Cursor, n8n):** load this actor as a tool through `https://mcp.apify.com?tools=actors,docs,k-data-lab/melon-scraper`. Client setup is further down this page, under "Use it from AI agents".

**Compare Korean charts:** the [Genie](https://apify.com/k-data-lab/genie-scraper) (play counts), [Bugs](https://apify.com/k-data-lab/bugs-scraper) (past hourly charts), [FLO](https://apify.com/k-data-lab/flo-scraper) (chart scores) and [NAVER VIBE](https://apify.com/k-data-lab/vibe-scraper) (daily charts since 2011, ISRC) actors use the same output format and price, so you can line up all five charts or spot an all-kill. The [combined chart actor](https://apify.com/k-data-lab/korean-music-chart-scraper) does it in one run.

**Good to know:** no lyrics, because they are copyrighted. Past charts are weekly and monthly only; to keep realtime or daily history, run the actor on a Schedule. If a run finds nothing, you pay only the run start. Unofficial tool, not affiliated with Melon / Kakao Entertainment.

***

### 🇰🇷 한국어 안내

멜론(Melon) **실시간 TOP100 · HOT100 · 일간 · 주간 · 월간 · 장르별 차트**와 **지난 주간·월간 차트**, **곡 검색**, **곡 상세(발매일·장르·작사·작곡·편곡)**, **앨범(평점·수록곡)**, \*\*아티스트(팬 수·곡 목록)\*\*를 **좋아요 수와 함께** JSON · CSV · Excel로 받아 보세요. 로그인도, 브라우저도 필요 없습니다.

| | |
|---|---|
| 💰 **가격** | 곡 **$0.25 / 1,000곡** (약 350원), 곡 상세 +$0.10 / 1,000곡, 앨범·아티스트 $1 / 1,000건 |
| 🎁 **무료** | 매달 곡 500개 + 곡 상세 100개 + 앨범 20개 + 아티스트 20명 무료 |
| ⚡ **속도** | TOP100 차트 + 좋아요 수 = 약 5초 (요청 2번) |
| 🔓 **로그인** | 필요 없음 (멜론 웹사이트에서 로그아웃 상태로 보이는 공개 정보만) |

> 비공식(unofficial) 도구입니다. Not affiliated with, endorsed or sponsored by Melon / Kakao Entertainment.

**한눈에 보는 결과** (실시간 TOP100, 실제 실행):

| rank | rankStatus | title | artist | likes |
|---|---|---|---|---|
| 1 | same | NEON | A2O, A2O LITE | 59,026 |

🎧 **다른 차트도 같이 보세요**: 같은 형식·같은 가격의 [지니](https://apify.com/k-data-lab/genie-scraper) (재생 수·청취자 수) · [벅스](https://apify.com/k-data-lab/bugs-scraper) (지난 날짜·시간대 차트) · [FLO](https://apify.com/k-data-lab/flo-scraper) (차트 점수) · [바이브](https://apify.com/k-data-lab/vibe-scraper) (2011년~ 지난 일간 차트·ISRC) 스크래퍼를 함께 돌리면 멜론·지니·벅스·FLO·바이브 5대 음원 차트를 한 번에 모을 수 있습니다 (올킬 확인, 플랫폼별 순위 비교).

#### 🎵 무엇을 가져오나요?

- **차트**: TOP100(실시간, 매시 갱신), HOT100, 일간, 주간, 월간. 일간·주간·월간은 **장르별 차트**(발라드, 댄스, 랩/힙합, R\&B, 인디, 트로트, 해외 POP, OST, J-POP 등 26개)도 됩니다.
- **지난 차트**: 원하는 주의 주간 차트, 원하는 달의 월간 차트 (예: 2025년 3월 둘째 주).
- **순위 변동**: `rankChange`(+상승 / -하락 / 0), `rankStatus`(up · down · same · new).
- **좋아요 수**: 모든 곡에 멜론 좋아요 수 (추가 요금 없음).
- **곡 상세** (선택): 발매일, 장르, FLAC 음질, 작사·작곡·편곡자(아티스트 ID 포함), 어제 순위.
- **곡 검색**: 검색어로 곡 찾기 (전체 · 곡명 · 아티스트명 · 앨범명), 검색어당 최대 2,000곡.
- **앨범**: 앨범 종류, 발매일, 장르, 발매사, 기획사, **평점·참여 수**, 좋아요 수, 수록곡 전체(곡별 좋아요 수), 앨범 소개.
- **아티스트**: **팬 수**, 데뷔일·데뷔곡, 활동 유형, 소속사, 수상 이력, 그리고 곡 목록(최신순·인기순, 최대 2,000곡).

#### 💡 왜 이 액터인가요?

- **좋아요 수가 기본 포함**: 차트·검색·아티스트·앨범 어디서든 곡마다 좋아요 수가 들어 있습니다. 팬덤 화력, 신곡 반응을 숫자로 비교할 수 있습니다.
- **작사·작곡·편곡 크레딧**: A\&R, 작곡가 분석, 저작권·퍼블리싱 리서치에 바로 쓸 수 있습니다.
- **지난 주간·월간 차트**: 과거 데이터를 쌓아 추이를 분석할 수 있습니다.
- **가장 저렴**: 곡 $0.25 / 1,000곡. 매달 무료 분량도 있습니다.
- **빠르고 안정적**: 멜론 페이지를 직접 읽고 브라우저를 띄우지 않습니다. 멜론이 요청을 거절하면 자동으로 Apify 프록시로 다시 시도하고, 빈 차트가 오면 다시 받아옵니다.
- **한 번 실행에 여러 개**: 여러 차트 × 여러 장르 + 검색어 + 곡 + 앨범 + 아티스트를 한 번에.

#### 📥 입력 예시

실시간 TOP100 (기본값):

```json
{ "charts": ["realtime"] }
```

일간·주간 발라드·댄스 차트, 곡 상세 포함:

```json
{
  "charts": ["day", "week"],
  "genres": ["GN0100", "GN0200"],
  "includeSongDetails": true
}
```

지난 차트 (2025-03-12가 속한 주의 주간 차트 + 2025년 3월 월간 차트):

```json
{ "charts": ["week", "month"], "chartDate": "2025-03-12" }
```

검색 · 곡 · 앨범 · 아티스트:

```json
{
  "searchKeywords": ["아이유", "밤양갱"],
  "maxResults": 100,
  "songs": ["https://www.melon.com/song/detail.htm?songId=1929324"],
  "albums": ["14535765"],
  "artists": ["261143"],
  "maxSongsPerArtist": 50,
  "artistSongOrder": "popular"
}
```

| 입력 | 설명 |
|---|---|
| `charts` | `realtime`(TOP100) · `hot100` · `day` · `week` · `month` 중 여러 개 |
| `genres` | 일간·주간·월간 장르 코드 (비우면 장르종합 `GN0000`, `DM0000` 국내종합, `AB0000` 해외종합 …) |
| `chartDate` | 지난 주간(YYYY-MM-DD, 그 주) · 월간(YYYY-MM) 차트 |
| `maxResults` | 차트·검색어마다 최대 곡 수 (기본 100) |
| `includeLikes` | 좋아요 수 (기본 켜짐, 무료) |
| `includeSongDetails` | 곡 상세 추가 (곡 상세 이벤트 요금) |
| `searchKeywords`, `searchIn` | 곡 검색어와 검색 범위 |
| `songs`, `albums`, `artists` | 멜론 ID 또는 melon.com 링크 |
| `maxSongsPerArtist`, `artistSongOrder` | 아티스트 곡 목록 수(0 = 정보만)와 정렬 |

#### 📤 출력 예시

차트 곡 (실제 실행 결과):

```json
{
  "type": "song",
  "source": "chart",
  "chartType": "realtime",
  "chartName": "TOP100 (실시간)",
  "chartNameEn": "TOP100 (realtime)",
  "chartPeriod": "2026.10.30 21:00",
  "rank": 1,
  "rankChange": 0,
  "rankStatus": "same",
  "songId": "603382333",
  "title": "NEON",
  "artist": "A2O, A2O LITE",
  "artists": [{ "artistId": "4531271", "name": "A2O" }, { "artistId": "5217450", "name": "A2O LITE" }],
  "albumId": "14644795",
  "albumTitle": "NEON",
  "likes": 59026,
  "imageUrl": "https://cdnimg.melon.co.kr/cm2/album/images/146/44/795/14644795_20261012141441_500.jpg",
  "songUrl": "https://www.melon.com/song/detail.htm?songId=603382333",
  "scrapedAt": "2026-10-30T12:10:52+00:00"
}
```

`includeSongDetails: true`이면 곡마다 이런 필드가 더해집니다 (일간 6위 Looks Can Kill – IVE (아이브), 크레딧은 앞 2명만 표시):

```json
{
  "releaseDate": "2026-10-19",
  "genre": "댄스",
  "flac": "Flac 16/24bit",
  "lyricists": [{ "artistId": "3264", "name": "개코" }, { "artistId": "631031", "name": "서지음" }],
  "composers": [{ "artistId": "3471318", "name": "Charles Roberts Nelsen" }, { "artistId": "3466931", "name": "Bava" }],
  "arrangers": [{ "artistId": "2190553", "name": "inverness" }, { "artistId": "3466931", "name": "Bava" }],
  "yesterdayRank": 6,
  "detailsScraped": true
}
```

앨범:

```json
{
  "type": "album",
  "albumId": "14535765",
  "title": "이 별로부터",
  "albumType": "싱글",
  "artist": "아이유",
  "releaseDate": "2026-09-10",
  "genre": "R&B/Soul, 록/메탈",
  "publisher": "카카오엔터테인먼트",
  "agency": "EDAM 엔터테인먼트",
  "likes": 14548,
  "rating": 4.82,
  "ratingCount": 2744,
  "trackCount": 2,
  "tracks": [
    { "disc": 1, "trackNo": 1, "songId": "603052339", "title": "이 별로부터", "artist": "아이유", "isTitleTrack": true, "likes": 34340 },
    { "disc": 1, "trackNo": 2, "songId": "603052340", "title": "Dear my crazy soulmate", "artist": "아이유", "isTitleTrack": true, "likes": 33568 }
  ],
  "albumUrl": "https://www.melon.com/album/detail.htm?albumId=14535765"
}
```

아티스트: `name`, `fans`(예: 아이유 699,843명), `debutDate`, `debutSong`, `activityType`, `agency`, `awards`, `imageUrl`, `artistUrl`.

영문 이름이 필요하면 `chartNameEn`, `genreNameEn`을 쓰세요. 데이터셋에는 **차트 · 곡 · 앨범 · 아티스트** 보기가 있고, 실행마다 `RUN_SUMMARY`(입력별 상태와 개수)가 저장됩니다.

#### 💰 비용은 얼마인가요?

| 이벤트 | 가격 (무료 등급 기준) | 매달 무료 |
|---|---|---|
| 곡 (차트·검색·아티스트 곡 1개, 좋아요 수 포함) | $0.00025 (약 0.35원) → Gold $0.00015 | 500곡 |
| 곡 상세 (선택, 곡 요금에 추가) | $0.0001 (약 0.14원) → Gold $0.00007 | 100곡 |
| 앨범 (수록곡·평점·좋아요 포함) | $0.001 (약 1.4원) → Gold $0.0007 | 20개 |
| 아티스트 (팬 수·프로필) | $0.001 (약 1.4원) → Gold $0.0007 | 20명 |
| 실행 시작 | $0.005 (약 7원) | |

예시: 매시간 TOP100을 한 달 동안 모으면 100곡 × 24 × 30 = 72,000곡 ≈ **$18 + 시작 $3.6** (약 3만 원). 매일 일간 TOP100이면 한 달 3,000곡 ≈ **$0.6 + $0.15** (약 1,000원).
환율은 1달러 ≈ 1,400원으로 계산했습니다. 실행 옵션의 \*\*최대 비용(Max total charge)\*\*을 정하면 그 금액에서 깔끔하게 멈춥니다.

#### 🚀 사용 방법

1. **Try for free**를 누릅니다.
2. 차트를 고르거나 검색어 · 곡 · 앨범 · 아티스트를 넣습니다.
3. **Start**를 누르고 몇 초 기다립니다.
4. 결과를 JSON · CSV · Excel로 내려받거나 API로 가져갑니다.
5. 차트 추이를 쌓으려면 **Schedule**로 매시간 또는 매일 실행하세요.

#### 📊 이렇게 씁니다

- **K-pop 차트 모니터링**: 매시간 TOP100을 쌓아 순위·좋아요 추이 대시보드, 1위 달성·차트인 알림.
- **기획사·A\&R**: 신곡의 차트 진입·좋아요 증가 속도를 경쟁 곡과 비교, 작곡가·편곡자 크레딧 분석.
- **마케팅·광고**: 장르별 인기곡으로 캠페인 BGM·인플루언서 콘텐츠 기획.
- **데이터·연구**: 지난 주간·월간 차트로 장르·아티스트 트렌드 연구.
- **AI 에이전트·챗봇**: "지금 멜론 1위 곡은?" 같은 질문에 최신 데이터로 답하기 (Apify MCP).

#### 🔌 API · 연동

```bash
curl -X POST "https://api.apify.com/v2/acts/k-data-lab~melon-scraper/run-sync-get-dataset-items?token=<YOUR_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"charts":["realtime"],"maxResults":10}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_TOKEN>")
run = client.actor("k-data-lab/melon-scraper").call(run_input={"charts": ["realtime", "day"]})
for song in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(song["rank"], song["title"], song["artist"], song["likes"])
```

Google Sheets, Make, n8n, Zapier, Slack 연동과 웹훅도 Apify 콘솔의 **Integrations** 탭에서 바로 연결됩니다.

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

Claude, ChatGPT, Cursor, VS Code, n8n에 [Apify MCP 서버](https://mcp.apify.com)로 `melon-scraper` 도구를 바로 붙일 수 있어요. 에이전트가 입력 스키마를 읽고 이 액터를 실행해 멜론 차트·곡·앨범 데이터를 받아 옵니다. (Give your AI agent a ready-made `melon-scraper` tool: it reads the input schema, runs this actor and gets the dataset back.)

- 이 액터만 (this actor only): `https://mcp.apify.com?tools=actors,docs,k-data-lab/melon-scraper`
- K-pop 차트 묶음 (Melon·Genie·Bugs·FLO·VIBE·통합 차트): `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**

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=actors,docs,k-data-lab/melon-scraper"
```

Claude Desktop: Settings → Connectors → Add custom connector에 같은 URL을 붙여 넣으세요.

**Cursor / VS Code** (`.cursor/mcp.json`; `.vscode/mcp.json`에서는 `"servers"`로 바꾸고 `"type": "http"` 추가)

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

**이렇게 물어보세요 (Try asking)**

- "Get today's Melon realtime TOP100 with like counts and tell me which songs are new in the top 10."
- "Pull last week's Melon weekly chart for 발라드 and list the songwriters of the top 20."
- "Find every NewJeans song on Melon and sort it by likes."
- "멜론 실시간 차트 TOP50 가져와서 좋아요 수 많은 순으로 정리해줘."

#### ❓ 자주 묻는 질문

**가사도 가져오나요?** 아니요. 가사는 저작권이 있는 콘텐츠라 넣지 않습니다. 대신 작사·작곡·편곡 크레딧을 드립니다.

**과거 일간·실시간 차트도 되나요?** 멜론은 지난 주간·월간 차트만 공개 페이지로 제공합니다. 실시간·HOT100·일간은 항상 최신 차트입니다. 매시간·매일 Schedule로 실행해 직접 쌓으시면 됩니다.

**검색 결과가 멜론 사이트와 순서가 다를 수 있나요?** 멜론의 기본 정렬(정확도순) 그대로 가져옵니다. 검색어당 최대 2,000곡입니다.

**`rankChange`가 null이면?** 신규 진입곡(`rankStatus: "new"`)입니다.

**결과가 비어 있으면 요금이 나가나요?** 결과가 없으면 곡·앨범·아티스트 요금은 없습니다 (실행 시작 요금만). 없는 ID는 `RUN_SUMMARY`에 `NOT_FOUND`로 표시되고, 실행은 정상 종료됩니다.

**프록시가 필요한가요?** 보통 필요 없습니다. 멜론이 요청을 거절하면 액터가 자동으로 Apify 프록시로 다시 시도합니다.

**개인정보는?** 멜론 웹사이트에 공개된 차트·곡·앨범·아티스트 정보만 가져옵니다. 회원 정보, 댓글 작성자 같은 개인 정보는 가져오지 않습니다. 비공식 도구이며 멜론(카카오엔터테인먼트)과 관계가 없습니다. 수집한 데이터는 멜론 이용약관과 저작권법을 지켜 사용해 주세요.

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

**한국 음원 차트 5종 세트** — 모두 로그인 불필요, $0.25 / 1,000곡, 같은 `type: "song"` 출력 형식이라 합쳐서 비교하기 쉽습니다.

| 액터 | 여기에만 있는 것 |
|---|---|
| **멜론** (이 액터) | 곡마다 좋아요 수, 작사·작곡·편곡 크레딧, 앨범 평점, 아티스트 팬 수 |
| [지니뮤직 차트 스크래퍼 (Genie Music Chart API)](https://apify.com/k-data-lab/genie-scraper) | 곡별 총 재생 수·청취자 수, 지난 일간·주간·월간 차트 |
| [벅스 차트 스크래퍼 (Bugs Music Chart API)](https://apify.com/k-data-lab/bugs-scraper) | 29개 장르 차트, 앨범 차트, 원하는 날짜·시간의 지난 차트 |
| [FLO 차트 스크래퍼 (FLO Music Chart API)](https://apify.com/k-data-lab/flo-scraper) | 곡별 차트 점수, 아티스트 인기 지수, 일간 TOP250 |
| [바이브 차트 스크래퍼 (NAVER VIBE Music Chart API)](https://apify.com/k-data-lab/vibe-scraper) | TOP300, 성·연령별 차트, 2011년~ 날짜별 지난 차트, ISRC |

그 밖의 액터:

- [Google Play Scraper API](https://apify.com/k-data-lab/google-play-scraper): 구글 플레이 앱 정보와 리뷰, 국가별, 로그인 불필요
- [Agoda Scraper](https://apify.com/k-data-lab/agoda-scraper): 아고다 호텔 가격, 객실 요금, 리뷰
- [Google Ads Transparency & Ad Library Scraper](https://apify.com/k-data-lab/google-ad-library-scraper): 경쟁사가 집행하는 구글 광고 전체
- [Amazon ASIN Rating & Review Count Scraper](https://apify.com/k-data-lab/amazon-asin-rating-scraper): 아마존 19개 마켓 ASIN 별점·리뷰 수
- [Amazon Seller Central Review Scraper & Monitor](https://apify.com/k-data-lab/amazon-seller-central-review-scraper): 셀러 센트럴 브랜드 리뷰 내보내기·모니터링

#### 💬 문의

빠진 필드나 틀린 값이 있으면 **Issues** 탭에 남겨 주세요. 당일에 답변드립니다.

***

Tags: melon chart, melon scraper, melon api, kpop chart, k-pop chart api, korean music chart, korean music, k-pop data, 멜론 차트, 멜론 크롤링, 멜론 api, 음원 차트, 케이팝 차트, 좋아요 수

# Actor input Schema

## `charts` (type: `array`):

Melon charts to fetch. Pass chart IDs as a list: realtime (TOP100, updated hourly), hot100, day (daily), week (weekly), month (monthly). Leave empty to skip charts and use only the search, song, album and artist inputs below. Example: \["realtime"] or \["day","week"]. 가져올 멜론 차트 (여러 개 선택 가능). 비워 두면 차트는 건너뜁니다.

## `genres` (type: `array`):

Genre codes for the daily, weekly and monthly charts; realtime and HOT100 ignore this. Empty = all genres (GN0000). Each genre returns its own chart. Example: \["DM0000"] = all Korean songs, \["GN0100","GN0200"] = ballad and dance. 비워 두면 장르종합입니다.

## `chartDate` (type: `string`):

Only for past weekly or monthly charts. Weekly: any day of that week as YYYY-MM-DD, e.g. 2026-10-08 returns the chart for Oct 5-11. Monthly: YYYY-MM, e.g. 2026-07. Empty = latest chart. Realtime, HOT100 and daily charts are always the latest. 지난 주간·월간 차트를 가져올 때만 입력합니다.

## `maxResults` (type: `integer`):

Maximum songs for each chart or search keyword. Charts stop at rank 100, search stops at 2,000 songs. Example: 100 = full TOP100, 10 = top 10 only (cheapest test). 차트 하나 또는 검색어 하나당 최대 곡 수입니다.

## `includeLikes` (type: `boolean`):

Adds the Melon like count to every song at no extra charge (one extra request per 100 songs). Example: true (default); false if you do not need likes. 추가 요금 없음.

## `includeSongDetails` (type: `boolean`):

Opens each song page to add release date, genre, FLAC info, lyricists, composers, arrangers and yesterday's rank. Adds the song-details event charge per song. Example: true if you need credits or release dates, false (default) for ranks only. 곡당 곡 상세 요금이 추가됩니다.

## `searchKeywords` (type: `array`):

Search Melon songs by keyword, such as an artist or song name. Returns up to the max songs setting per keyword. Empty = no search. Example: \["IU", "NewJeans"] or \["아이유", "밤양갱"]. 멜론 곡 검색어입니다.

## `searchIn` (type: `string`):

Where to look for the keyword. all = everything (default), song = song titles, artist = artist names, album = album titles. Example: "artist". 검색어를 어디에서 찾을지 고릅니다.

## `songs` (type: `array`):

Melon song IDs or song page links. Returns details and the like count for each song. Empty = skip. Example: \["603382333"] or \["https://www.melon.com/song/detail.htm?songId=603382333"]. 멜론 곡 ID 또는 링크.

## `albums` (type: `array`):

Melon album IDs or album page links. Returns album info, rating, like count and tracklist. Empty = skip. Example: \["14535765", "https://www.melon.com/album/detail.htm?albumId=14535765"]. 멜론 앨범 ID 또는 링크.

## `artists` (type: `array`):

Melon artist IDs or artist page links. Returns the profile, fan count and song list. Empty = skip. Example: \["261143"] (IU). 멜론 아티스트 ID 또는 링크.

## `maxSongsPerArtist` (type: `integer`):

Songs to fetch for each artist; 0 = profile only. Example: 50 (default), or 0 for the profile only. 0이면 아티스트 정보만 가져옵니다.

## `artistSongOrder` (type: `string`):

Order of the artist song list: latest (newest first, default) or popular. Example: "popular". 최신순 또는 인기순.

## `proxyConfiguration` (type: `object`):

Usually not needed. If Melon refuses a request, the actor retries through Apify Proxy on its own. Example: {"useApifyProxy": false} (default); {"useApifyProxy": true} forces the proxy. 보통 필요 없습니다.

## Actor input object example

```json
{
  "charts": [
    "realtime"
  ],
  "maxResults": 100,
  "includeLikes": true,
  "includeSongDetails": false,
  "searchKeywords": [],
  "searchIn": "all",
  "maxSongsPerArtist": 50,
  "artistSongOrder": "latest",
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

## `chart` (type: `string`):

No description

## `songs` (type: `string`):

No description

## `albums` (type: `string`):

No description

## `artists` (type: `string`):

No description

## `all` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "charts": [
        "realtime"
    ],
    "maxResults": 100,
    "searchKeywords": [],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("k-data-lab/melon-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "charts": ["realtime"],
    "maxResults": 100,
    "searchKeywords": [],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("k-data-lab/melon-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "charts": [
    "realtime"
  ],
  "maxResults": 100,
  "searchKeywords": [],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call k-data-lab/melon-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,k-data-lab/melon-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/5oc6dVK8HsNlSBnKE/builds/zwzMlmhqsCvXHjAFq/openapi.json