# NAVER VIBE Chart API – Korean Music & K-pop Charts, Past Charts (`k-data-lab/vibe-scraper`) Actor

Get NAVER VIBE (바이브) Korean music chart data as an API, no login: K-pop Top 100 down to rank 300, rising, age×gender, karaoke and 26 genre charts, past charts back to 1961, song search, credits, ISRC, album and artist likes. JSON/CSV. $0.25/1K songs, first 500 songs a month free.

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

## Pricing

from $0.15 / 1,000 곡·차트 항목 (song / chart row)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

## NAVER VIBE Chart API – Korean Music & K-pop Charts, Past Charts, ISRC

**Get NAVER VIBE (바이브) Korean music chart data as JSON, CSV or an API, with no login and no browser.** One run gives you the K-pop Today Top 100 **down to rank 300**, the rising charts, **10 age × gender charts**, the karaoke and music-search TOP100s, **26 genre charts** and **past charts back to 1961**. Every chart song comes with rank, rank change, a new-entry flag and its **ISRC**.

| | |
|---|---|
| 🎁 **First run is free** | Click **Start**: the default input returns today's Top 100 (100 songs) in about 4 seconds. The first 500 songs each month are free, so you pay only the $0.005 start fee, which Apify's free monthly credit covers. |
| 💰 **Price** | $0.25 per 1,000 songs (about 350원) · song details/credits +$0.15 / 1,000 · albums and artists $1 / 1,000 |
| 🔓 **Login** | Not needed. Only public data that VIBE shows to logged-out visitors |
| 🤖 **AI agents (MCP)** | `https://mcp.apify.com?tools=actors,docs,k-data-lab/vibe-scraper` (setup below) |

```json
{ "rank": 1, "rankChange": 0, "isNew": false, "title": "NEON", "artist": "A2O, A2O LITE", "isrc": "KRMIM2655904",
  "albumTitle": "NEON", "releaseDate": "2026-10-13", "genre": "댄스", "chartName": "오늘 Top 100", "chartDate": "2026-10-31T07:00:00+09:00" }
```

> Unofficial tool, not affiliated with, endorsed or sponsored by NAVER / VIBE. [Full English guide ↓](#english-summary)

**🇰🇷 한국어:** 네이버 바이브(VIBE)의 **오늘 Top 100 (300위까지)**, **국내·해외 급상승**, **성·연령별 차트 10개** (10~50대 여성·남성), **VIBE 노래방 TOP100**, **음악검색 TOP100**, **장르 차트 26개**, 그리고 \*\*지난 차트 (1961년~어제)\*\*를 JSON · CSV · Excel로 받아 보세요. **곡 검색**, **곡 크레딧 (작사·작곡·편곡, 참여자 ID 포함)**, **앨범 (좋아요 수·수록곡)**, \*\*아티스트 (좋아요 수·데뷔일·멤버·소속사)\*\*도 가져옵니다. 로그인도, 브라우저도 필요 없습니다. 기본 입력 그대로 **Start**를 누르면 오늘 Top 100(100곡)이 약 4초 만에 나오고, 매달 500곡까지는 무료입니다.

| | |
|---|---|
| 💰 **가격** | 곡·차트 항목 **$0.25 / 1,000개** (약 350원), 곡 상세(크레딧) +$0.15 / 1,000곡 (약 210원), 앨범·아티스트 $1 / 1,000건 (약 1,400원) |
| 🎁 **무료** | 매달 곡·차트 항목 500개 + 곡 상세 100개 + 앨범 20개 + 아티스트 20명 무료 |
| ⚡ **속도** | 오늘 Top 100 = 약 4초 (요청 1번), 장르 차트 26개(2,600곡) = 약 25초, 곡 1,700개 + 크레딧 = 약 3분 |
| 🔓 **로그인** | 필요 없음 (VIBE 웹에서 로그아웃 상태로 보이는 공개 정보만) |

> 📊 Need **Melon, Genie, Bugs, FLO and VIBE in one table** (all-kill check)? Use the [Korean Music Charts API (통합 음원차트 스크래퍼)](https://apify.com/k-data-lab/korean-music-chart-scraper).

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

- **종합 차트**: 오늘 Top 100 (전일 24시간, 1인 1회 스트리밍 반영, 매일 갱신) **300위까지**, 국내 급상승·해외 급상승 TOP100 (1개월 이내 발매곡, 매시 갱신).
- **성·연령별 차트 10개**: 10대·20대·30대·40대·50대 × 여성·남성 인기곡 TOP100. 다른 스트리밍 차트 스크래퍼에는 없는 데이터입니다.
- **VIBE 노래방 TOP100** (노래방 기능 사용 횟수), **음악검색 TOP100** (VIBE·네이버 앱의 음악 검색 횟수).
- **장르 차트 26개 (TOP100)**: K-Pop, 국내 발라드·댄스·일렉트로닉·랩/힙합·알앤비/소울·락/메탈·재즈·인디·포크/어쿠스틱, 트로트 / Pop, 해외 댄스·일렉트로닉·랩/힙합·알앤비/소울·락/메탈·재즈·인디·포크/어쿠스틱 / OST, 클래식, 뉴에이지, J-Pop, CCM, 월드뮤직.
- **지난 차트**: 국내·해외 TOP100을 **2011년~어제는 날짜별(일간)**, **2008~2010년은 주간**, **1961~2007년은 연도별**로 가져옵니다. 예: 2020-12-25 국내 TOP100, 1999년 해외 인기곡.
- **차트 지표**: `rank`, `rankChange` (+상승 / -하락 / 0), `isNew` (신규 진입), 차트 기준 시각(`chartDate`)과 VIBE가 설명하는 집계 기준.
- **곡 정보**: 곡명, 아티스트 전원(ID 포함), 앨범·발매일·장르, **기획사·유통사**, **ISRC**(차트), 디스크·트랙 번호, 타이틀곡·19금·노래방 지원·돌비 애트모스 표시, 커버 이미지.
- **곡 상세** (선택): 재생시간, MP3 가격, 싱크 가사 유무, 해외곡 여부, **작사·작곡·편곡자와 전체 크레딧** (참여자 VIBE ID와 좋아요 수).
- **곡 검색**: 검색어로 곡 찾기 (정확도순·인기순·최신순), 검색어당 최대 2,000곡.
- **앨범**: 정규 여부, 발매일, 장르, 기획사·유통사, **좋아요 수**, 수록곡 전체, 전체 재생시간.
- **아티스트**: **좋아요 수(팬 수)**, 데뷔일, 성별, 그룹 여부와 **멤버 목록(멤버별 좋아요 수)**, 소속사, 장르, 활동 연대, 소개, 그리고 곡 목록 (인기순·최신순).

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

- **Apify 스토어의 유일한 바이브 액터**: 다른 K-pop 차트 도구는 멜론·지니·벅스만 다루고 바이브는 없습니다.
- **성·연령별 차트**: "20대 여성이 듣는 곡", "50대 남성 인기곡" 같은 타깃별 차트를 그대로 가져옵니다.
- **지난 차트 65년치**: 2011년부터는 하루 단위로 원하는 날짜의 국내·해외 TOP100을 받을 수 있어, 예약 실행 없이도 과거 순위 데이터를 만들 수 있습니다.
- **TOP300 + ISRC**: 오늘 Top 100은 300위까지, 차트 곡의 약 90%에 ISRC가 있어 다른 플랫폼 데이터와 정확하게 맞출 수 있습니다.
- **좋아요 수**: 앨범·아티스트·멤버·작곡가 좋아요 수로 팬덤 규모를 숫자로 비교합니다.
- **가장 저렴**: $0.25 / 1,000곡. 다른 K-pop 차트 도구($0.50~$2 / 1,000곡)보다 2~8배 저렴하고 매달 무료 분량도 있습니다.
- **빠르고 안정적**: VIBE 웹이 쓰는 공개 데이터를 그대로 읽고 브라우저를 띄우지 않습니다. 요청이 거절되면 자동으로 Apify 프록시로 다시 시도하고, 빈 차트가 오면 다시 받아옵니다.

#### 📥 입력 예시

오늘 Top 100 (기본값):

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

TOP300 + 20대 여성·남성 + 노래방 차트, 크레딧 포함:

```json
{
  "charts": ["total", "gen-f20", "gen-m20", "karaoke"],
  "maxResults": 300,
  "includeSongDetails": true
}
```

지난 차트 (국내 + 해외):

```json
{
  "pastChartDates": ["2025-10-31", "2020-12-25", "2009-06-15", "1999"],
  "pastChartRegion": "both"
}
```

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

```json
{
  "searchKeywords": ["아이유", "aespa"],
  "searchSort": "popular",
  "maxResults": 100,
  "songs": ["https://vibe.naver.com/track/108385046"],
  "albums": ["1781318"],
  "artists": ["143179"],
  "maxSongsPerArtist": 50,
  "artistSongOrder": "popular"
}
```

| 입력 | 설명 |
|---|---|
| `charts` | `total`(오늘 Top 100, 300위) · `domestic-rising` · `oversea-rising` · `karaoke` · `search` · 성·연령 `gen-f10`~`gen-f50`, `gen-m10`~`gen-m50` · 장르 `kpop` `kr-ballad` `kr-dance` `kr-electronic` `kr-hiphop` `kr-rnb` `kr-rock` `kr-jazz` `kr-indie` `kr-folk` `trot` `pop` `dance` `electronic` `hiphop` `rnb` `rock` `jazz` `indie` `folk` `ost` `classic` `newage` `jpop` `ccm` `world` |
| `maxResults` | 차트·검색어마다 최대 결과 수 (기본 100, 오늘 Top 100은 300위까지) |
| `includeSongDetails` | 곡 상세 추가: 재생시간·크레딧 (곡 상세 이벤트 요금) |
| `pastChartDates`, `pastChartRegion` | 지난 차트 날짜(YYYY-MM-DD, 2008-01-01~어제) 또는 연도(1961~2007), 지역(국내·해외·둘 다) |
| `searchKeywords`, `searchSort` | 곡 검색어와 정렬(정확도순·인기순·최신순) |
| `songs`, `albums`, `artists` | VIBE ID 또는 vibe.naver.com 링크 |
| `maxSongsPerArtist`, `artistSongOrder` | 아티스트 곡 목록 수(0 = 정보만)와 정렬(인기순·최신순) |

#### 📤 출력 예시

오늘 Top 100 1위 + 곡 상세 (실제 실행 결과):

```json
{
  "type": "song",
  "source": "chart",
  "chartKey": "total",
  "chartId": "top100-daily-TOTAL_V2",
  "chartName": "오늘 Top 100",
  "chartCode": "daily",
  "chartDate": "2026-10-31T07:00:00+09:00",
  "chartUpdated": "10월 31일 오전 7시 업데이트",
  "chartBasis": "전일 0시부터 24시간 동안 아이디 1개당 1회의 스트리밍을 반영한 차트입니다.",
  "rank": 1,
  "rankChange": 0,
  "isNew": false,
  "songId": "108385046",
  "title": "NEON",
  "artist": "A2O, A2O LITE",
  "artistId": "11079406",
  "artists": [{ "artistId": "11079406", "name": "A2O" }, { "artistId": "11079405", "name": "A2O LITE" }],
  "albumId": "38847773",
  "albumTitle": "NEON",
  "releaseDate": "2026-10-13",
  "genre": "댄스",
  "agency": "A2O Entertainment",
  "distributor": "지니뮤직, STONE MUSIC",
  "discNumber": 1,
  "trackNumber": 1,
  "isrc": "KRMIM2655904",
  "duration": "03:28",
  "durationSeconds": 208,
  "isTitleTrack": true,
  "isAdult": false,
  "hasLyric": true,
  "isStreamable": true,
  "isDownloadable": true,
  "isKaraokeEnabled": true,
  "hasDolbyAtmos": false,
  "downloadPriceKrw": 700,
  "isOversea": false,
  "imageUrl": "https://musicmeta-phinf.pstatic.net/album/038/847/38847773.jpg?type=r480Fll&v=20261012105605",
  "songUrl": "https://vibe.naver.com/track/108385046",
  "hasSyncLyric": true,
  "credits": [{ "role": "작사", "name": "Dem Jointz", "artistId": "453249", "likeCount": 7 }, { "role": "작사", "name": "유영진", "artistId": "1752", "likeCount": 408 }, "…"],
  "lyricists": ["Dem Jointz", "유영진"],
  "composers": ["Dem Jointz", "유영진"],
  "arrangers": ["Dem Jointz", "유영진"],
  "detailsScraped": true,
  "scrapedAt": "2026-10-31T18:11:45+00:00"
}
```

지난 차트 · 앨범 · 아티스트 (요약):

```json
{ "type": "song", "source": "past-chart", "chartKey": "past-domestic", "chartName": "2025-10-31 국내 Top 100",
  "pastChartDate": "2025-10-31", "rank": 1, "title": "Golden", "artist": "HUNTR/X, EJAE, AUDREY NUNA, REI AMI, KPop Demon Hunters Cast" }
{ "type": "album", "albumId": "1781318", "title": "YOU NEVER WALK ALONE", "artist": "방탄소년단", "albumType": "정규",
  "releaseDate": "2017-02-13", "genre": "랩/힙합", "agency": "BIGHIT MUSIC", "distributor": "YG PLUS", "likeCount": 29004, "trackCount": 18 }
{ "type": "artist", "artistId": "143179", "name": "방탄소년단", "likeCount": 194775, "debutDate": "2013-06-13", "gender": "남성",
  "isGroup": true, "agency": "빅히트 뮤직", "members": [{ "artistId": "274317", "name": "RM", "likeCount": 12826 }, "…"] }
```

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

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

| 이벤트 | 가격 | 무료 (매달) |
|---|---|---|
| 곡·차트 항목 (차트·지난 차트·검색·아티스트 목록의 곡 1개) | $0.25 / 1,000개 (약 350원) | 500개 |
| 곡 상세 (재생시간·크레딧 추가) | +$0.15 / 1,000곡 (약 210원) | 100곡 |
| 앨범 (앨범 ID로 조회) | $1 / 1,000개 (약 1,400원) | 20개 |
| 아티스트 (아티스트 ID로 조회) | $1 / 1,000명 (약 1,400원) | 20명 |
| 실행 시작 | $0.005 / 실행 (약 7원) | – |

예: 오늘 Top 100(300위)을 매일 한 달 모으면 곡 9,000개 ≈ $2.25 (약 3,150원) + 시작 $0.15. 2011~2025년 매월 1일 국내 TOP100(180개 차트, 18,000곡)은 한 번에 ≈ $4.5 (약 6,300원).
Apify 등급(Bronze · Silver · Gold)에 따라 곡 가격은 최대 $0.15 / 1,000곡까지 내려갑니다. 실행 옵션의 **최대 비용**(Max cost)을 정하면 그 금액에서 깨끗하게 멈춥니다.

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

- **기획사·A\&R**: 신곡의 바이브 순위와 급상승 차트 진입, 성·연령별 반응을 매일 추적.
- **마케팅·광고**: 20대 여성·40대 남성 등 타깃층이 실제로 듣는 곡으로 캠페인 음악 선정.
- **음악 데이터 분석·연구**: 2011년부터의 일간 TOP100으로 장기 트렌드, 장르 변화, 롱런 곡 분석.
- **저작권·퍼블리싱**: ISRC, 작사·작곡·편곡자, 기획사·유통사별로 차트 진입곡 집계.
- **멜론·지니·벅스·FLO와 함께 비교**: [멜론](https://apify.com/k-data-lab/melon-scraper) · [지니](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) 차트 스크래퍼와 같은 시각에 돌려 플랫폼별 순위 비교 (올킬 체크).
- **AI 에이전트·챗봇**: "오늘 바이브 1위 곡은?", "2015년 오늘 1위는?" 같은 질문에 답하기 (Apify MCP).

#### 🔌 API · 연동

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

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_TOKEN>")
run = client.actor("k-data-lab/vibe-scraper").call(run_input={"pastChartDates": ["2020-12-25"], "pastChartRegion": "both"})
for song in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(song["chartName"], song["rank"], song["title"], song["artist"])
```

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 `vibe-scraper` tool through [Apify's MCP server](https://mcp.apify.com): 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/vibe-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**

```bash
claude mcp add --transport http apify "https://mcp.apify.com?tools=actors,docs,k-data-lab/vibe-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"`)

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

**Try asking / 이렇게 물어보세요**

- "Get NAVER VIBE's Today Top 100 and list the new entries with their ISRC codes."
- "What was VIBE's #1 song on 2020-12-25? Pull that day's past chart."
- "Compare the VIBE karaoke TOP100 with the K-Pop genre chart and list songs in both."
- "VIBE 오늘 Top 100에서 신규 진입곡만 골라서 순위·아티스트 표로 정리해줘."

#### ❓ 자주 묻는 질문

**지난 차트는 어디까지 되나요?** 국내·해외 TOP100 기준으로 2011-01-01부터 어제까지는 날짜별(일간) 차트, 2008~2010년은 그 날짜가 속한 주의 주간 차트, 1961~2007년은 연도별 차트입니다 (VIBE가 그렇게 보관합니다). 1961~2007년 연도 차트는 VIBE가 당시 차트·수상 이력·재생 데이터를 종합해 만든 차트입니다. 성·연령별·장르·노래방 차트는 현재 차트만 제공합니다.

**오늘 날짜의 지난 차트는요?** VIBE는 매일 오전 7시쯤 전날 기준 차트를 올립니다. 아직 올라오지 않은 날짜는 `NOT_FOUND`로 표시되고 요금이 나가지 않습니다.

**`rankChange`의 부호는?** +는 상승, -는 하락, 0은 유지입니다 (직전 차트와 비교한 VIBE 값).

**ISRC가 비어 있는 곡이 있어요.** ISRC는 차트 결과에만 나오고, 그중 약 90%에 있습니다. VIBE가 ISRC를 등록하지 않은 곡은 비어 있습니다.

**재생수는요?** VIBE는 곡별 재생수를 공개하지 않습니다. 순위·급상승·좋아요 수를 드립니다. 재생수·청취자수가 필요하면 [지니 차트 스크래퍼](https://apify.com/k-data-lab/genie-scraper)를 쓰세요.

**가사도 가져오나요?** 아니요. 가사는 저작권이 있는 콘텐츠라 넣지 않습니다 (`hasLyric`, `hasSyncLyric`로 유무만 표시). 대신 작사·작곡·편곡과 전체 크레딧을 드립니다.

**크레딧이 비어 있는 곡이 있어요.** VIBE가 작사·작곡 정보를 등록하지 않은 곡(주로 해외·클래식·오래된 곡)입니다. 차트 1,700곡 기준 약 97%에 크레딧이 있습니다.

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

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

**개인정보·이용 범위는?** VIBE 웹에 공개된 차트·곡·앨범·아티스트 정보만 가져옵니다. 회원 정보, 보관함·플레이리스트, 가사, 댓글은 가져오지 않습니다. 요청은 적은 동시 접속(3개)으로 천천히 보냅니다. 수집한 데이터는 VIBE 이용약관과 저작권법을 지켜 사용하시고, AI 모델 학습에는 쓰지 마세요. 비공식 도구이며 네이버(NAVER)·VIBE와 관계가 없습니다.

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

**Korean music charts (K-chart set)**

- [Korean Music Charts API (통합 음원차트)](https://apify.com/k-data-lab/korean-music-chart-scraper): Melon, Genie, Bugs, FLO and VIBE ranks merged into one row per song, with an all-kill flag
- [Melon Chart API (멜론)](https://apify.com/k-data-lab/melon-scraper): Melon TOP100, HOT100, genre charts and like counts
- [Genie Music Chart API (지니)](https://apify.com/k-data-lab/genie-scraper): Genie TOP200 with play and listener counts per song
- [Bugs Music Chart API (벅스)](https://apify.com/k-data-lab/bugs-scraper): Bugs TOP100, 29 genre charts, past charts, likes and credits
- [FLO Music Chart API (플로)](https://apify.com/k-data-lab/flo-scraper): FLO charts, daily TOP250, chart score and popularity index

**Korea data**

- [KB Land Scraper (KB부동산)](https://apify.com/k-data-lab/kbland-scraper): Korean apartment prices (KB 시세 sale/jeonse/rent), real transactions and listing counts
- [R114 Scraper (부동산114)](https://apify.com/k-data-lab/r114-scraper): 부동산114 sale and jeonse valuations, 10-year price history and real transactions

**Social, video and apps**

- [YouTube Scraper](https://apify.com/k-data-lab/youtube-scraper): videos, channels and search results with exact views and likes
- [YouTube Comments Scraper](https://apify.com/k-data-lab/youtube-comments-scraper): comments and replies with numeric like counts
- [TikTok Scraper](https://apify.com/k-data-lab/tiktok-scraper): public TikTok videos and profiles, exact follower counts, transcripts
- [X Tweet Scraper](https://apify.com/k-data-lab/x-tweet-scraper): tweet data and MP4 video links from tweet URLs or IDs, no login
- [Telegram Channel Scraper](https://apify.com/k-data-lab/telegram-channel-scraper): public channel messages and keyword search, no login
- [Google Play Scraper API](https://apify.com/k-data-lab/google-play-scraper): Google Play app data and reviews by country, no login
- [App Store Scraper](https://apify.com/k-data-lab/app-store-scraper): iOS app data and reviews, past the 500-review RSS cap

**Maps, travel and food**

- [Google Maps Scraper](https://apify.com/k-data-lab/google-maps-scraper): business leads by search or area: phone, website, emails, hours and ratings
- [Agoda Scraper](https://apify.com/k-data-lab/agoda-scraper): Agoda hotel prices, room offers and reviews
- [Airline Award Seat Scraper](https://apify.com/k-data-lab/airline-award-seat-scraper): live award seat availability on Alaska Atmos Rewards and partner airlines
- [Uber Eats & Deliveroo Scraper](https://apify.com/k-data-lab/uber-eats-deliveroo-scraper): restaurants, full menus, dish prices, delivery fees and ratings

**Ads and Amazon**

- [Google Ads Transparency & Ad Library Scraper](https://apify.com/k-data-lab/google-ad-library-scraper): every Google ad a competitor runs
- [Amazon ASIN Rating & Review Count Scraper](https://apify.com/k-data-lab/amazon-asin-rating-scraper): ratings and review counts across 19 Amazon marketplaces
- [Amazon Seller Central Review Scraper](https://apify.com/k-data-lab/amazon-seller-central-review-scraper): your own brand's reviews from Seller Central, with your own session

#### 💬 문의

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

***

#### English summary

**NAVER VIBE Music Chart Scraper API**: scrape VIBE (바이브), NAVER's music streaming service in Korea, without login. You get Today's Top 100 **down to rank 300**, domestic and overseas rising charts (hourly), **10 age × gender charts** (women/men in their 10s–50s), the VIBE Karaoke TOP100, the Music Search TOP100 and **26 genre charts**. **Past charts**: domestic and overseas TOP100 for any day since 2011, weekly charts for 2008–2010 and yearly charts for 1961–2007. Chart songs include **ISRC**, rank change and new-entry flags, album genre, agency and distributor. **Song details** add duration, MP3 price, synced-lyrics flag and full credits (lyricists, composers, arrangers with VIBE artist IDs and like counts). Also song search (relevance/popular/latest, up to 2,000 per keyword), albums (like count, tracklist, agency, distributor) and artists (like count, debut date, members, agency, songs by popularity or date). Output as JSON/CSV/Excel or via API. **$0.25 per 1,000 songs**; 500 songs, 100 song details, 20 albums and 20 artists are free every month. The only VIBE actor on the Apify Store. Unofficial, not affiliated with NAVER / VIBE. No lyrics, no user data.

**FAQ (English)**

- **How do I get NAVER VIBE chart data as an API?** Call `k-data-lab/vibe-scraper` with `{"charts":["total"]}` through the Apify API (curl/Python examples above), or connect it to Make, n8n, Zapier or an AI agent through the Apify MCP server.
- **Can I get a K-pop chart from a past date?** Yes. Put dates in `pastChartDates`, e.g. `["2020-12-25"]`. Daily charts exist from 2011-01-01 to yesterday, weekly charts for 2008–2010 and yearly charts for 1961–2007.
- **Does VIBE show play counts?** No, VIBE doesn't publish them. You get ranks, rank change, likes and ISRC. For play counts, use the [Genie scraper](https://apify.com/k-data-lab/genie-scraper).
- **What about other Korean music charts?** [Melon](https://apify.com/k-data-lab/melon-scraper), [Genie](https://apify.com/k-data-lab/genie-scraper), [Bugs](https://apify.com/k-data-lab/bugs-scraper), [FLO](https://apify.com/k-data-lab/flo-scraper), or all five platforms merged in the [Korean Music Charts API](https://apify.com/k-data-lab/korean-music-chart-scraper).

Tags: vibe chart, korean music chart api, k-pop rankings, naver vibe scraper, vibe music api, 바이브 차트, 네이버 바이브, 바이브 크롤링, kpop chart, k-pop chart api, korean music chart, 음원 차트, 케이팝 차트, 지난 차트

# Actor input Schema

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

Which NAVER VIBE charts to get (chart IDs, pick any number). "total" = Today Top 100, down to rank 300; every other chart goes to rank 100. Also: "domestic-rising"/"oversea-rising", "karaoke", "search", 10 age×gender charts ("gen-f20" = women in their 20s, "gen-m40" = men in their 40s) and 26 genres ("kpop", "kr-ballad", "trot", "pop", "ost"…). Each song comes with rank, rank change, new-entry flag and ISRC. Example: \["total"] or \["kpop", "karaoke"]. Leave empty to skip charts and use only the past-chart/search/song/album/artist inputs below.

차트 ID 목록. 예: \["total"] = 오늘 Top 100, \["kpop", "karaoke"] = K-Pop 장르 + 노래방 TOP100. 가져올 VIBE 차트 (여러 개 선택 가능). 오늘 Top 100은 300위까지, 나머지는 100위까지입니다. 성·연령별 차트 10개(10~50대 여성·남성), 노래방 TOP100, 음악검색 TOP100, 장르 차트 26개도 있습니다. 곡마다 순위 변동, 신규 진입, ISRC가 함께 나옵니다. 비워 두면 차트는 건너뛰고 아래 지난 차트·검색어·곡·앨범·아티스트만 가져옵니다.

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

Max songs per chart or per search keyword. Today Top 100 goes to 300, other charts and past charts to 100, search to 2,000. Example: 100 = full TOP100, 300 = Today Top 100 to rank 300, 10 = top 10 only.

차트 하나 또는 검색어 하나당 최대 곡 수. 오늘 Top 100은 300위, 다른 차트와 지난 차트는 100위까지, 검색은 최대 2,000곡까지입니다. 예: 100 = TOP100 전체, 300 = 오늘 Top 100의 300위까지, 10 = 상위 10곡만.

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

Add duration, MP3 price, synced-lyrics flag, overseas flag and full credits (lyricists, composers, arrangers with VIBE artist IDs and like counts) to every chart/search/artist song. Adds the 'song details' event per song. Lyrics text is never included. Example: true if you need songwriter credits, false (default) for ranks only.

차트·검색·아티스트 곡마다 곡 정보를 한 번 더 불러 재생시간, 다운로드 가격, 싱크 가사 유무, 해외곡 여부, 작사·작곡·편곡자와 전체 크레딧(참여자 VIBE ID·좋아요 수 포함)을 추가합니다. 곡당 '곡 상세' 이벤트 요금이 추가됩니다. 가사 본문은 저작권 때문에 넣지 않습니다. 예: 작사·작곡 크레딧이 필요하면 true, 순위만 필요하면 false(기본값).

## `pastChartDates` (type: `array`):

Past chart dates as YYYY-MM-DD, from 2008-01-01 to yesterday (e.g. "2025-10-31", "2020-12-25"). From 2011 you get that day's daily TOP100; for 2008–2010 the TOP100 of the week containing the date. For 1961–2007 enter just the year (e.g. "1999") for that year's chart. Leave empty to skip.

YYYY-MM-DD 형식의 날짜 (2008-01-01 ~ 어제, 예: 2025-10-31, 2020-12-25). 2011년부터는 그날의 일간 TOP100, 2008~2010년은 그 날짜가 속한 주의 주간 TOP100입니다 (VIBE가 그 시기는 주간 차트만 보관). 1961~2007년은 연도만(예: 1999) 넣으면 그해의 연도 차트를 가져옵니다. 비워 두면 지난 차트는 가져오지 않습니다.

## `pastChartRegion` (type: `string`):

Region for past charts: "domestic" = Korean songs (default), "oversea" = international songs, "both". Only used with pastChartDates. Example: "both".

지난 차트를 국내·해외 중 어느 쪽으로 가져올지. "domestic" = 국내(기본값), "oversea" = 해외, "both" = 둘 다. pastChartDates를 넣었을 때만 쓰입니다. 예: "both".

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

VIBE song search keywords: artist or song names in Korean or English (e.g. "아이유", "aespa", "밤양갱"). Up to maxResults songs per keyword. Leave empty to skip.

VIBE 곡 검색어 (예: 아이유, 에스파, 밤양갱). 검색어마다 최대 결과 수만큼 가져옵니다. 비워 두면 검색하지 않습니다.

## `searchSort` (type: `string`):

Sort order for song search: "relevance" (default), "popular" or "latest". Example: "popular" for the biggest hits first.

곡 검색 결과 정렬 순서. "relevance" = 정확도순(기본값), "popular" = 인기순, "latest" = 최신순. 예: 인기곡부터 보려면 "popular".

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

VIBE song IDs or links (e.g. "108385046" or "https://vibe.naver.com/track/108385046"). Song details (credits) are always included (song + song details events). Leave empty to skip.

VIBE 곡 ID 또는 링크 (예: 108385046 또는 https://vibe.naver.com/track/108385046). 곡 상세(크레딧)가 항상 포함됩니다 (곡 + 곡 상세 이벤트). 비워 두면 건너뜁니다.

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

VIBE album IDs or links (e.g. "38847773" or "https://vibe.naver.com/album/38847773"). One row per album: release date, genre, agency, distributor, like count and full tracklist. Leave empty to skip.

VIBE 앨범 ID 또는 링크 (예: 38847773 또는 https://vibe.naver.com/album/38847773). 앨범 정보(발매일·장르·기획사·유통사·좋아요 수)와 전체 수록곡 목록을 한 행으로 가져옵니다. 비워 두면 건너뜁니다.

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

VIBE artist IDs or links (e.g. "112579" = IU, "143179" = BTS, or "https://vibe.naver.com/artist/112579"). Returns like count (fans), debut date, agency, members and the artist's songs. Leave empty to skip.

VIBE 아티스트 ID 또는 링크 (예: 112579 = 아이유, 143179 = 방탄소년단, 또는 https://vibe.naver.com/artist/112579). 아티스트 정보(좋아요 수·데뷔일·소속사·멤버)와 곡 목록을 가져옵니다. 비워 두면 건너뜁니다.

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

Songs to fetch per artist (0 = artist info only). Example: 50. Only used with artists.

아티스트마다 가져올 곡 수 (0 = 아티스트 정보만). 예: 50 = 곡 50개, 0 = 아티스트 정보만. artists를 넣었을 때만 쓰입니다.

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

Order of each artist's song list: "popular" (default) or "latest". Example: "latest" for newest releases first.

아티스트 곡 목록의 정렬 순서. "popular" = 인기순(기본값), "latest" = 최신순. 예: 최신 발매곡부터 보려면 "latest".

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

Usually not needed: if VIBE refuses a direct request, the actor retries through Apify Proxy automatically. Example: {"useApifyProxy": false} (keep the default).

보통은 필요 없습니다. VIBE가 직접 요청을 거부하면 자동으로 Apify 프록시로 다시 시도합니다. 예: {"useApifyProxy": false} (기본값 그대로 두면 됩니다).

## Actor input object example

```json
{
  "charts": [
    "total"
  ],
  "maxResults": 100,
  "includeSongDetails": false,
  "pastChartDates": [],
  "pastChartRegion": "domestic",
  "searchKeywords": [],
  "searchSort": "relevance",
  "songs": [],
  "albums": [],
  "artists": [],
  "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": [
        "total"
    ],
    "maxResults": 100,
    "pastChartDates": [],
    "searchKeywords": [],
    "songs": [],
    "albums": [],
    "artists": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("k-data-lab/vibe-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": ["total"],
    "maxResults": 100,
    "pastChartDates": [],
    "searchKeywords": [],
    "songs": [],
    "albums": [],
    "artists": [],
}

# Run the Actor and wait for it to finish
run = client.actor("k-data-lab/vibe-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": [
    "total"
  ],
  "maxResults": 100,
  "pastChartDates": [],
  "searchKeywords": [],
  "songs": [],
  "albums": [],
  "artists": []
}' |
apify call k-data-lab/vibe-scraper --silent --output-dataset

```

## MCP server setup

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