# 지니뮤직 차트·곡·앨범 스크래퍼 (Genie Music Chart API) – 재생수·청취자수 (`k-data-lab/genie-scraper`) Actor

Get Genie Music (지니뮤직) charts as JSON: Korean music and K-pop realtime, daily, weekly and monthly TOP200, genre and past charts, with total plays, listeners, likes and credits per song. Song search, albums, artists. No login. $0.25/1K songs, 500 songs free monthly.

- **URL**: https://apify.com/k-data-lab/genie-scraper.md
- **Developed by:** [K-Data Lab](https://apify.com/k-data-lab) (community)
- **Categories:** Social media, AI
- **Features:** Limited permissions
- **Stats:** 1 total users, 0 monthly users, 93.3% 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

## Genie Music Chart API (지니뮤직) – K-pop TOP200 with Total Plays & Listeners

**Get the Genie Music chart as JSON, CSV or Excel with no login and no cookies.** This Korean music chart scraper returns the K-pop realtime TOP200, the daily, weekly and monthly TOP200, 12 genre charts and past charts since 2013, with **total plays, total listeners and likes for each song**, songwriter credits and Genie chart badges.

**▶ Your first run is on us:** click **Try for free** and leave the form as it is. You get the realtime TOP20 with plays and listeners in about 10 seconds, inside the free monthly quota. Only the $0.005 start fee applies, which Apify's free monthly credit covers.

Real output from that first run (Genie realtime chart, 2026-11-06 12:00 KST):

| rank | title | artist | totalPlays | totalListeners | likes |
|---|---|---|---:|---:|---:|
| 1 | 꿈꾸던 어른이 되었나요? | 머무르 | 7,872,638 | 594,265 | 21,776 |
| 2 | NEON | A2O & A2O LITE | 6,240,318 | 573,385 | 15,047 |
| 3 | With | RESCENE (리센느) | 576,049 | 146,180 | 4,533 |

| | |
|---|---|
| 💰 **Price / 가격** | **$0.25 / 1,000 songs** (약 350원), song details +$0.20 / 1,000 (약 280원), albums·artists $1 / 1,000 (약 1,400원) |
| 🎁 **Free every month / 무료** | 500 songs + 100 song details + 20 albums + 20 artists (곡 500개 · 곡 상세 100개 · 앨범 20개 · 아티스트 20명) |
| ⚡ **Speed / 속도** | Realtime TOP100 in about 5 s (2 requests), TOP200 with details in about 1 min (실시간 TOP100 약 5초, TOP200 + 곡 상세 약 1분) |
| 🔓 **Login / 로그인** | None, public pages only (필요 없음, 지니 웹사이트에서 로그아웃 상태로 보이는 공개 정보만) |

지니(Genie Music) **실시간 TOP200 · 일간 · 주간 · 월간 차트**, **장르별 차트**(가요·트롯·POP·OST·JPOP·EDM 등), **지난 차트**, **곡 검색**, **곡 상세(좋아요 · 전체 재생수 · 전체 청취자수 · 작사·작곡·편곡 · 차트 뱃지)**, **앨범**, \*\*아티스트(곡 목록 포함)\*\*를 JSON · CSV · Excel로 받아 보세요. 로그인도, 브라우저도 필요 없습니다. 처음 실행은 폼을 그대로 두고 시작을 누르면 실시간 TOP20을 재생수·청취자수와 함께 약 10초 만에 무료 분량 안에서 가져옵니다 (실행 시작 요금 $0.005만 발생).

> 비공식(unofficial) 도구입니다. Not affiliated with, endorsed or sponsored by Genie Music / KT Genie Music.

🎧 **다른 차트도 같이 보세요**: 같은 형식·같은 가격의 [멜론](https://apify.com/k-data-lab/melon-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) (지난 일간 차트·ISRC) 스크래퍼를 함께 돌리면 지니·멜론·벅스·FLO·바이브 5대 음원 차트를 한 번에 모을 수 있습니다 (올킬 확인, 플랫폼별 순위 비교).

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

- **차트**: 실시간 TOP200(매시 갱신), 일간 TOP200, 주간 TOP200, 월간 TOP200.
- **장르별 차트**: 일간·주간 장르 TOP100. 가요, 트롯, POP, OST, JPOP, EDM, JAZZ, CLASSIC, 뉴에이지, CCM, 동요/태교, 그 외 장르 (12개).
- **지난 차트**: 원하는 날의 일간 차트, 원하는 주의 주간 차트, 원하는 달의 월간 차트 (2013년 이후).
- **순위 변동**: `rankChange`(+상승 / -하락 / 0), `rankStatus`(up · down · same · new).
- **곡 상세** (선택): **좋아요 수, 전체 재생수, 전체 청취자수**, 장르, 재생시간, 작사·작곡·편곡자(아티스트 ID 포함), **지니 차트 뱃지**(예: "주간차트 1위", "일간차트 10위 진입"과 날짜).
- **곡 검색**: 검색어로 곡 찾기 (지니 검색 순서), 검색어당 최대 3,000곡.
- **앨범**: 발매일, 장르, 발매사, 기획사, 좋아요 수, 수록곡 전체(타이틀곡 표시), 앨범 소개(크레딧 포함).
- **아티스트**: 좋아요 수, 지니 등록 곡 수, 활동유형, 활동연대, 데뷔 연도, 국적, 그리고 곡 목록 (인기순 전체·3개월·1주, 최신순, 곡명순).

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

- **재생수·청취자수**: 지니 곡 페이지의 전체 재생수와 전체 청취자수를 그대로 가져옵니다. 다른 차트 스크래퍼에는 없는 "누적 스트리밍" 지표입니다.
- **TOP200 전체 + 장르 + 지난 차트**: 실시간 TOP100만 주는 도구와 달리 지니의 모든 공개 차트를 날짜별로 가져올 수 있습니다.
- **차트 뱃지 이력**: 곡이 언제 일간·주간·월간 몇 위에 올랐는지 날짜와 함께. 역주행·롱런 분석에 좋습니다.
- **가장 저렴**: 곡 $0.25 / 1,000곡. 다른 K-pop 차트 도구($2 / 1,000곡)보다 8배 저렴하고 매달 무료 분량도 있습니다.
- **정확한 날짜**: 아직 집계되지 않은 날짜를 넣으면 최신 차트를 엉뚱한 날짜로 붙이지 않고, "가장 최근 차트는 ○○입니다"라고 알려 줍니다.
- **빠르고 안정적**: 지니 페이지를 직접 읽고 브라우저를 띄우지 않습니다. 요청이 거절되면 자동으로 Apify 프록시로 다시 시도하고, 빈 차트가 오면 다시 받아옵니다.

#### 📥 입력 예시

첫 실행 (폼 기본값): 실시간 TOP20 + 재생수·청취자수, 무료 분량 안에서:

```json
{ "charts": ["realtime"], "maxResults": 20, "includeSongDetails": true }
```

API 기본값: 실시간 TOP100, 순위만 (곡 상세 없음, 더 빠르고 저렴):

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

일간·주간 가요·트롯 차트, 곡 상세(재생수·청취자수) 포함:

```json
{
  "charts": ["day", "week"],
  "genres": ["M0100", "M0107"],
  "includeSongDetails": true
}
```

지난 차트 (2026년 1월 1일 일간 TOP200):

```json
{ "charts": ["day"], "chartDate": "2026-01-01", "maxResults": 200 }
```

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

```json
{
  "searchKeywords": ["아이유", "에스파"],
  "maxResults": 100,
  "songs": ["https://www.genie.co.kr/detail/songInfo?xgnm=87034188"],
  "albums": ["88135998"],
  "artists": ["67872918"],
  "maxSongsPerArtist": 50,
  "artistSongOrder": "popular"
}
```

| 입력 | 설명 |
|---|---|
| `charts` | `realtime`(실시간 TOP200) · `day` · `week` · `month` 중 여러 개 |
| `genres` | 일간·주간 장르 코드 (비우면 전체 TOP200, `M0100` 가요, `M0107` 트롯, `M0200` POP, `M0300` OST, `M0400` JPOP, `E0000` EDM …) |
| `chartDate` | 지난 일간(YYYY-MM-DD) · 주간(그 주의 아무 날짜) · 월간(YYYY-MM) 차트 |
| `maxResults` | 차트·검색어마다 최대 곡 수 (기본 100, 전체 차트 최대 200, 장르 차트 최대 100) |
| `includeSongDetails` | 곡 상세 추가: 좋아요·재생수·청취자수·크레딧·뱃지 (곡 상세 이벤트 요금) |
| `searchKeywords` | 곡 검색어 (지니 검색은 `%` 를 받지 않아 빼고 검색합니다: `100%` → `100`) |
| `songs`, `albums`, `artists` | 지니 ID 또는 genie.co.kr 링크 |
| `maxSongsPerArtist`, `artistSongOrder` | 아티스트 곡 목록 수(0 = 정보만)와 정렬 |

#### 📤 출력 예시

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

```json
{
  "type": "song",
  "source": "chart",
  "chartType": "realtime",
  "chartName": "실시간 TOP200",
  "genreCode": "ALL",
  "chartPeriod": "2026.10.31 03:00",
  "chartDate": "2026-10-31",
  "rank": 2,
  "rankChange": 1,
  "rankStatus": "up",
  "songId": "117241316",
  "title": "Star Trace",
  "artist": "PLAVE",
  "artistId": "81835454",
  "albumId": "88265992",
  "albumTitle": "HYPERDRIVE",
  "isAdult": false,
  "imageUrl": "https://image.genie.co.kr/Y/IMAGE/IMG_ALBUM/088/265/992/88265992_1791352016055_1_600x600.JPG",
  "songUrl": "https://www.genie.co.kr/detail/songInfo?xgnm=117241316",
  "scrapedAt": "2026-10-30T18:10:57+00:00"
}
```

`includeSongDetails: true`이거나 곡 ID로 조회하면 곡마다 이런 필드가 더해집니다 (밤편지 – 아이유, 뱃지는 앞 3개만 표시):

```json
{
  "genre": "가요 / 발라드",
  "duration": "04:13",
  "durationSeconds": 253,
  "lyricists": [{ "artistId": "67872918", "name": "아이유 (IU)" }],
  "composers": [{ "artistId": "80529758", "name": "김희원" }, { "artistId": "80591238", "name": "제휘" }],
  "arrangers": [{ "artistId": "80529758", "name": "김희원" }, { "artistId": "80591238", "name": "제휘" }],
  "likes": 114506,
  "totalListeners": 4692365,
  "totalPlays": 151569827,
  "badges": [
    { "date": "2017-05-01", "title": "월간차트 10위 진입" },
    { "date": "2017-04-03", "title": "주간차트 1위" },
    { "date": "2017-03-25", "title": "일간차트 1위" }
  ],
  "detailsScraped": true
}
```

앨범과 아티스트 (요약):

```json
{ "type": "album", "albumId": "88135998", "title": "이 별로부터", "artist": "아이유 (IU)", "releaseDate": "2026-09-10",
  "genre": "락 / 가요", "publisher": "카카오엔터테인먼트", "agency": "EDAM엔터테인먼트", "likes": 1298, "trackCount": 2,
  "tracks": [{ "trackNo": 1, "songId": "116789223", "title": "이 별로부터", "isTitleTrack": true }, "…"] }
{ "type": "artist", "artistId": "67872918", "name": "아이유 (IU)", "likes": 97798, "songCount": 181,
  "activityType": "여성/솔로", "activeDecades": ["2000년대", "2010년대", "2020년대"], "debutYear": 2008, "nationality": "한국" }
```

실행이 끝나면 키-값 저장소의 `RUN_SUMMARY`에 입력별 결과(OK · NOT_FOUND · SKIPPED · NO_RESULTS), 이번 달 남은 무료 분량, 요청 수가 남습니다.

#### 💰 가격 (Pay per event)

| 이벤트 | 가격 | 무료 (매달) |
|---|---|---|
| 곡 (차트·검색·아티스트 목록의 곡 1개) | $0.25 / 1,000곡 (약 350원) | 500곡 |
| 곡 상세 (재생수·청취자수·좋아요·크레딧·뱃지 추가) | +$0.20 / 1,000곡 (약 280원) | 100곡 |
| 앨범 | $1 / 1,000개 (약 1,400원) | 20개 |
| 아티스트 | $1 / 1,000명 (약 1,400원) | 20명 |
| 실행 시작 | $0.005 / 실행 (약 7원) | – |

예: 실시간 TOP100을 매시간 한 달(720번) 모으면 곡 72,000개 ≈ $18 + 시작 $3.6. 일간 TOP200을 매일 모으면 한 달 ≈ $1.65.
Apify 등급(Bronze · Silver · Gold)에 따라 곡 가격은 최대 $0.15 / 1,000곡까지 내려갑니다. 실행 옵션의 **최대 비용**(Max cost)을 정하면 그 금액에서 깨끗하게 멈춥니다.

#### 🎯 이런 분께 좋아요

- **기획사·A\&R**: 신곡의 실시간 순위, 재생수·청취자수 증가, 장르 차트 위치를 매시간 추적.
- **팬덤·커뮤니티 운영**: 아티스트 전곡의 재생수, 차트 뱃지(1위·10위 진입) 이력을 한 번에 정리.
- **음악 데이터 분석·연구**: 지난 일간·주간·월간 차트로 장르·아티스트 트렌드, 역주행, 롱런 분석.
- **5대 차트 비교 (올킬 체크)**: [멜론](https://apify.com/k-data-lab/melon-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) 스크래퍼와 같은 시각에 돌려 플랫폼별 순위를 비교.
- **AI 에이전트·챗봇**: "지금 지니 1위 곡은?" 같은 질문에 최신 데이터로 답하기 (Apify MCP).

#### 🔌 API · 연동

```bash
curl -X POST "https://api.apify.com/v2/acts/k-data-lab~genie-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/genie-scraper").call(run_input={"charts": ["realtime"], "includeSongDetails": True})
for song in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(song["rank"], song["title"], song["artist"], song.get("totalPlays"))
```

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

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

**Tool for AI agents: fetch the Genie Music chart, K-pop TOP200, song plays and listeners.** Claude, ChatGPT, Cursor, VS Code, n8n에 [Apify MCP 서버](https://mcp.apify.com)로 `genie-scraper` 도구를 바로 붙일 수 있어요. 에이전트가 입력 스키마를 읽고 이 액터를 실행해 지니 차트·곡·앨범 데이터를 받아 옵니다. (Give your AI agent a ready-made `genie-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/genie-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/genie-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/genie-scraper",
      "headers": { "Authorization": "Bearer <YOUR_APIFY_TOKEN>" }
    }
  }
}
```

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

- "Get the Genie realtime TOP200 and show the top 20 with their total plays and listeners."
- "Pull Genie's daily 트롯 chart for 2026-10-01 and list the artists."
- "Look up IU on Genie and list her 30 most popular songs."
- "지니 주간 차트 TOP100에서 에스파 곡만 뽑아서 재생수와 함께 보여줘."

#### ❓ 자주 묻는 질문

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

**지난 시간의 실시간 차트도 되나요?** 아니요. 지니는 실시간 차트를 현재 시각 것만 공개합니다. 매시간 Schedule로 실행해 직접 쌓으세요. 일간·주간·월간은 지난 날짜를 넣을 수 있습니다.

**장르별 월간 차트는요?** 지니가 장르 차트를 일간·주간만 공개합니다. 월간 + 장르를 고르면 그 조합은 `SKIPPED`로 건너뛰고 나머지는 정상 수집합니다.

**오늘 날짜를 넣었는데 결과가 없어요.** 일간 차트는 보통 다음 날 공개됩니다. 아직 집계되지 않은 날짜면 "가장 최근 일간 차트는 ○○입니다"라는 메시지가 `RUN_SUMMARY`와 상태 메시지에 나옵니다. 날짜를 비우면 항상 최신 차트입니다.

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

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

**입력이 잘못되면 어떻게 되나요?** 잘못된 ID·날짜·차트 코드는 `RUN_SUMMARY`에 `INVALID_INPUT`과 이유가 표시되고 건너뜁니다. 나머지 입력은 그대로 실행되며, 실행은 정상 종료됩니다. 입력을 하나도 넣지 않으면 기본값인 실시간 TOP100을 가져옵니다.

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

**개인정보·이용 범위는?** 지니 웹사이트에 공개된 차트·곡·앨범·아티스트 정보만 가져옵니다. 베스트 청취자, 댓글 작성자 같은 회원 정보는 가져오지 않습니다. 요청은 적은 동시 접속으로 천천히 보냅니다. 지니 페이지에는 AI 학습 사용을 원하지 않는다는 표시(noai)가 있으니, 수집한 데이터를 AI 모델 학습에 쓰지 마시고 지니 이용약관과 저작권법을 지켜 사용해 주세요. 비공식 도구이며 지니뮤직과 관계가 없습니다.

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

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

| 액터 | 여기에만 있는 것 |
|---|---|
| **지니** (이 액터) | 곡별 전체 재생수·청취자수, TOP200, 차트 뱃지 이력, 지난 일간·주간·월간 차트 |
| [멜론 차트 스크래퍼 (Melon K-pop Chart API)](https://apify.com/k-data-lab/melon-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, 성·연령별 차트, 날짜별 지난 차트, ISRC |
| [통합 음원차트 API (Korean Music · K-pop Chart)](https://apify.com/k-data-lab/korean-music-chart-scraper) | 5개 플랫폼 차트를 한 표로: 플랫폼별 순위, 통합 순위, 올킬 여부 |

그 밖의 액터:

- [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): 셀러 센트럴 브랜드 리뷰 내보내기·모니터링
- [YouTube Scraper API](https://apify.com/k-data-lab/youtube-scraper): 영상·쇼츠·채널·검색 결과, 로그인 불필요
- [Telegram Scraper API](https://apify.com/k-data-lab/telegram-channel-scraper): 공개 채널 메시지와 키워드 검색, 로그인 불필요
- [KB Land Korea Apartment Price API](https://apify.com/k-data-lab/kbland-scraper): KB부동산 아파트 시세·전세·실거래
- [R114 Korea Apartment Price & Jeonse API](https://apify.com/k-data-lab/r114-scraper): 부동산114 아파트 시세·실거래가
- [Airline Award Seat Scraper API](https://apify.com/k-data-lab/airline-award-seat-scraper): 항공 마일리지 좌석, 세금, 잔여 좌석
- [Uber Eats & Deliveroo Scraper API](https://apify.com/k-data-lab/uber-eats-deliveroo-scraper): 음식점, 메뉴, 가격, 배달비

#### 💬 문의

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

***

#### English FAQ

**How do I get the Genie Music chart as JSON?** Run this actor with `{"charts":["realtime"],"maxResults":100}`, or use `day`, `week` or `month`. Every row has `rank`, `rankChange`, `title`, `artist`, `albumTitle` and `songId`. Results come as JSON, CSV or Excel, or through the API.

**How do I get total plays or streaming counts for a K-pop song?** Set `includeSongDetails` to `true`, or pass song IDs in `songs`. Each song gains `totalPlays`, `totalListeners` and `likes`, as Genie shows them on the song page.

**How do I get a past Korean music chart?** Add `chartDate`: `2026-01-01` for a daily chart, any day of the week for a weekly chart, `2026-07` for a monthly chart. Past charts go back to 2013. Genie doesn't publish past realtime charts, so schedule hourly runs to build that history.

**Can I compare Genie with Melon, Bugs, FLO and VIBE?** Yes. The sibling actors use the same output and price, and the [Korean Music Chart API](https://apify.com/k-data-lab/korean-music-chart-scraper) merges all five charts into one table with all-kill flags.

**What doesn't it return?** Lyrics and listener profiles. It is unofficial and not affiliated with Genie Music.

Tags: genie chart, genie music scraper, genie music api, genie chart api, kpop chart, k-pop chart api, korean music chart, korean music chart api, k-pop streaming data, all-kill, 지니 차트, 지니뮤직 크롤링, 지니 api, 음원 차트, 재생수, 케이팝 차트

# Actor input Schema

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

Which Genie Music charts to fetch; pick several if needed. Pass chart IDs: realtime (current TOP200, updated hourly), day (daily), week (weekly), month (monthly, last month by default). Leave empty to skip charts and only use the search, song, album and artist inputs below. Example: \["realtime"] or \["day","week"]. 가져올 지니 차트를 고르세요 (여러 개 선택 가능). 실시간은 매시 갱신되는 현재 TOP200, 일간·주간은 지니에 공개된 가장 최근 차트, 월간은 지난달 차트입니다. 비워 두면 차트는 건너뛰고 아래 검색어·곡·앨범·아티스트만 가져옵니다. 차트 ID 목록으로 넘기세요: realtime(실시간 TOP200), day(일간), week(주간), month(월간). 예: \["realtime"] 또는 \["day","week"].

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

Genre chart for the daily and weekly charts. Empty = overall TOP200. Each genre chart has up to 100 ranks, and each genre you pick fetches its own chart. The realtime and monthly charts have no genres. Pass genre codes. Example: \["M0100"] = K-pop/가요, \["M0107","M0300"] = trot and OST. 일간·주간 차트의 장르. 비워 두면 전체 TOP200입니다. 장르 차트는 장르마다 TOP100까지 있습니다. 여러 장르를 고르면 장르마다 차트를 하나씩 가져옵니다. 실시간·월간 차트에는 장르가 없습니다 (지니가 제공하지 않음). 장르 코드 목록으로 넘기세요. 예: \["M0100"] = 가요, \["M0107","M0300"] = 트롯·OST.

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

Only for past charts; empty = latest chart. Daily: YYYY-MM-DD (2026-01-01). Weekly: any day of that week (2026-10-08). Monthly: YYYY-MM (2026-07). The realtime chart is always the current hour. 지난 차트를 가져올 때만 입력. 일간: YYYY-MM-DD (예: 2026-01-01). 주간: 그 주에 속한 아무 날짜 (예: 2026-10-08 → 그 주 월~일 차트). 월간: YYYY-MM (예: 2026-07). 비워 두면 최신 차트입니다. 실시간 차트는 항상 현재 시각입니다.

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

Maximum songs for each chart or each search term. Limits: overall chart 200, genre chart 100, search 3,000. Example: 10 = TOP10, 100 = TOP100, 200 = full TOP200. 차트 하나 또는 검색어 하나당 최대 곡 수. 전체 차트는 200위, 장르 차트는 100위까지, 검색은 최대 3,000곡까지입니다. 예: 100 = TOP100, 200 = 전체 차트 TOP200, 10 = TOP10만.

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

Opens each song page to add likes, totalPlays, totalListeners, genre, duration, lyricists, composers, arrangers and Genie chart badges. Costs one song-details event per song (100 free each month) and makes the run slower. Example: true if you need play or listener counts, false if ranks are enough. API default: false. 차트·검색·아티스트 곡마다 곡 상세 페이지를 열어 좋아요 수, 전체 재생수, 전체 청취자수, 장르, 재생시간, 작사·작곡·편곡자, 차트 뱃지(예: '주간차트 10위 진입')를 추가합니다. 곡당 '곡 상세' 이벤트 요금이 추가되고 실행 시간이 길어집니다. 예: 재생수·청취자수가 필요하면 true, 순위만 필요하면 false (기본값).

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

Genie song search terms, in Genie search order, up to the max songs value per term. Korean names match best. Empty = no search. Example: \["아이유", "에스파"]. 지니 곡 검색어 (예: 아이유, 에스파, 밤양갱). 검색어마다 지니 검색 순서대로 최대 곡 수만큼 가져옵니다. 비워 두면 검색하지 않습니다. 예: \["아이유", "에스파"].

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

Genie song IDs or song URLs; returns full details for each song (likes, plays, listeners, credits). Empty = skip. Example: \["87034188"]. 지니 곡 ID 또는 곡 링크 (예: 87034188, https://www.genie.co.kr/detail/songInfo?xgnm=87034188). 곡마다 상세 정보(좋아요·재생수·청취자수·작사·작곡)를 가져옵니다. 비워 두면 건너뜁니다. 예: \["87034188"].

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

Genie album IDs or album URLs; returns release date, label, agency, likes, intro text and tracklist. Empty = skip. Example: \["88135998"]. 지니 앨범 ID 또는 앨범 링크 (예: 88135998, https://www.genie.co.kr/detail/albumInfo?axnm=88135998). 발매일, 발매사, 기획사, 좋아요 수, 앨범 소개, 수록곡 목록을 가져옵니다. 비워 두면 건너뜁니다. 예: \["88135998"].

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

Genie artist IDs or artist URLs; returns the artist profile, likes and song list. Empty = skip. Example: \["67872918"] = IU. 지니 아티스트 ID 또는 링크 (예: 67872918 = 아이유, https://www.genie.co.kr/detail/artistInfo?xxnm=67872918). 아티스트 정보와 좋아요 수, 그리고 곡 목록을 가져옵니다. 비워 두면 건너뜁니다. 예: \["67872918"].

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

Songs to fetch for each artist; 0 = profile only. Example: 50 (default). 아티스트마다 가져올 곡 수 (0 = 아티스트 정보만). 예: 50 (기본값), 아티스트 정보만 원하면 0.

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

Order of the artist song list: popular (default, all time), popular90 (last 90 days), popular7 (last 7 days), latest, name. Example: "latest". 아티스트 곡 목록의 정렬 순서 (지니 아티스트 페이지와 같은 기준). popular = 인기순 (기본값), popular90 / popular7 = 최근 90일·7일 인기순, latest = 최신순, name = 이름순. 예: "latest".

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

Usually not needed: if Genie refuses a request, the actor retries through Apify Proxy by itself. Example: {"useApifyProxy": false} (default). 보통 필요 없습니다. 지니가 요청을 거절하면 자동으로 Apify 프록시로 다시 시도합니다. 예: {"useApifyProxy": false} (기본값). 프록시를 강제하려면 {"useApifyProxy": true}.

## Actor input object example

```json
{
  "charts": [
    "realtime"
  ],
  "maxResults": 20,
  "includeSongDetails": true,
  "searchKeywords": [],
  "maxSongsPerArtist": 50,
  "artistSongOrder": "popular",
  "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": 20,
    "includeSongDetails": true,
    "searchKeywords": [],
    "proxyConfiguration": {
        "useApifyProxy": false
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("k-data-lab/genie-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": 20,
    "includeSongDetails": True,
    "searchKeywords": [],
    "proxyConfiguration": { "useApifyProxy": False },
}

# Run the Actor and wait for it to finish
run = client.actor("k-data-lab/genie-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": 20,
  "includeSongDetails": true,
  "searchKeywords": [],
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}' |
apify call k-data-lab/genie-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,k-data-lab/genie-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/QfniBRB4c1AovQnLj/builds/fGtrYbE36tdmfwvoa/openapi.json