# FLO 차트·곡·앨범 스크래퍼 (FLO Music Chart API) – 차트 점수·인기 지수 (`k-data-lab/flo-scraper`) Actor

Get FLO (플로) Korean music chart data via API, no login: K-pop (kpop) TOP100 updated hourly, daily TOP250, weekly and 17 genre charts, rising artists, song search, credits, albums and artists, each song with its FLO chart score. 500 songs free monthly, then $0.25/1K. 플로 차트 API.

- **URL**: https://apify.com/k-data-lab/flo-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

## FLO Music Chart API (플로 차트) – K-pop TOP100 & Chart Scores

**FLO Music Chart API** is an unofficial tool that returns Korea's FLO (플로) K-pop charts as JSON, CSV or Excel without a login: the hourly FLO Chart TOP100, the daily overall TOP250, the weekly TOP100, 17 genre charts and the Rising Artists TOP100. Every chart song carries FLO's own chart score, so you see the gap between #1 and #2, not just the order. Click **Start** and the prefilled input returns the current FLO Chart TOP100 in about 5 seconds. **Your first run is free:** the first 500 songs every month cost nothing (a TOP100 run is 100 songs), then $0.25 per 1,000 songs. On Apify's Free plan you don't need a card.

FLO(플로) **FLO 차트 TOP100**(최근 24시간, 매시 갱신), **일간 종합 TOP250**, **주간 종합 TOP100**, **장르 차트 17개**(국내 발라드·댄스/일렉·힙합·알앤비·트로트·인디 / 해외 팝·힙합·알앤비·일렉트로닉 / OST·J-POP·클래식·CCM 등), **라이징 아티스트 TOP100**, **곡 검색**, **곡 상세(장르 · 작사·작곡·편곡 · 뮤직비디오)**, **앨범**, \*\*아티스트(곡 목록 포함)\*\*를 JSON · CSV · Excel로 받아 보세요. 곡마다 **FLO 차트 점수**와 **인기 지수**가 함께 나옵니다. 로그인도, 브라우저도 필요 없습니다.

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

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

**기본값 그대로 실행한 결과** (FLO 차트, 2026.11.01 10:00 차트, 처음 3곡):

| rank | title | artist | chartScore | rankChange | chartName |
|---|---|---|---|---|---|
| 1 | 이 밤을 빌려 말해요 | PLAVE | 148678 | 0 | FLO 차트 |
| 2 | Star Trace | PLAVE | 136225 | 0 | FLO 차트 |
| 3 | 푸른 하늘에 단비 | PLAVE | 130350 | 0 | FLO 차트 |

곡마다 `songId` · `albumId` · `artists`(참여 아티스트 전원 + ID) · `isNew` · `chartPeriodStart`/`chartPeriodEnd` · `imageUrl` · `songUrl`도 함께 나오고, `includeSongDetails: true`를 켜면 장르와 작사·작곡·편곡 크레딧, 뮤직비디오 정보가 붙습니다. 전체 필드는 아래 [출력 예시](#-출력-예시)를 보세요.

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

- **종합 차트**: FLO 차트 TOP100 (최근 24시간 집계, 매시 갱신), 일간 종합 **TOP250** (최근 7일 집계, 매일 갱신), 주간 종합 TOP100.
- **장르 차트 17개 (매일 갱신, TOP100)**: 국내 발라드, 국내 댄스/일렉, 국내 힙합, 국내 알앤비, 트로트, 국내 인디, 국내 팝/어쿠스틱 / 해외 팝, 해외 힙합, 해외 알앤비, 해외 일렉트로닉 / OST/BGM, 클래식, 뉴에이지, 키즈, J-POP, CCM.
- **라이징 아티스트 TOP100**: 요즘 뜨는 아티스트 순위, 급상승 표시, FLO가 보여 주는 상승 이유(예: "청취량 상승세", "리스너 급상승").
- **차트 지표**: `chartScore` (곡별 FLO 차트 점수), `rankChange` (+상승 / -하락 / 0), `isNew` (신규 진입), 차트 집계 기준과 게시 기간.
- **곡 상세** (선택): 장르·스타일, 서비스 시작 일시, 작사·작곡·편곡자, **전체 참여 정보**(역할별), **뮤직비디오**(ID·제목·길이·공개일·등급·썸네일).
- **곡 검색**: 검색어로 곡 찾기 (FLO 정확도순), 검색어당 최대 2,000곡, 중복 제거.
- **앨범**: 유형(정규·미니·싱글·OST), 발매일, 장르, **유통사**, **레이블(기획사)**, 수록곡 전체(디스크·트랙 번호, 타이틀곡 표시, 재생시간), 전체 재생시간, 앨범 소개.
- **아티스트**: 성별, 활동 유형(솔로·그룹), 장르, 현재 차트 순위, 그리고 곡 목록 (인기순·최신순). \*\*곡마다 FLO 인기 지수(`popularity`)\*\*가 들어 있습니다.

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

- **Apify 스토어의 유일한 FLO 액터**: 다른 K-pop 차트 도구는 멜론·지니·벅스만 다루고 FLO는 빠져 있습니다. 이 액터는 FLO의 모든 공개 차트를 가져옵니다.
- **순위 + 점수**: 순위만이 아니라 곡별 **FLO 차트 점수**를 줘서 1위와 2위의 격차, 하루 사이 점수 변화를 숫자로 비교할 수 있습니다. 아티스트 곡 목록에는 **인기 지수**도 있습니다.
- **일간 종합 TOP250**: FLO 일간 종합 차트는 100위가 아니라 250위까지 다 가져옵니다.
- **참여 아티스트 전원**: 피처링·콜라보 곡도 `artists`에 아티스트 전원과 ID가 들어 있습니다.
- **가장 저렴**: $0.25 / 1,000곡. 다른 K-pop 차트 도구($0.50~$2 / 1,000곡)보다 2~8배 저렴하고 매달 무료 분량도 있습니다.
- **빠르고 안정적**: FLO 웹 플레이어가 쓰는 공개 데이터를 그대로 읽고 브라우저를 띄우지 않습니다. 요청이 거절되면 자동으로 Apify 프록시로 다시 시도하고, 빈 차트가 오면 다시 받아옵니다.

#### 📥 입력 예시

FLO 차트 TOP100 (기본값):

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

일간 종합 TOP250 + 발라드·트로트·J-POP 장르 차트, 곡 상세(크레딧·MV) 포함:

```json
{
  "charts": ["day", "kr-ballad", "trot", "jpop"],
  "maxResults": 250,
  "includeSongDetails": true
}
```

라이징 아티스트 + 검색 · 곡 · 앨범 · 아티스트:

```json
{
  "charts": ["rising"],
  "searchKeywords": ["아이유", "aespa"],
  "maxResults": 100,
  "songs": ["https://www.music-flo.com/detail/track/611656860/details"],
  "albums": ["464803660"],
  "artists": ["80049126"],
  "maxSongsPerArtist": 50,
  "artistSongOrder": "popular"
}
```

| 입력 | 설명 |
|---|---|
| `charts` | `flo`(FLO 차트) · `day`(일간 종합 TOP250) · `week`(주간 종합) · 장르 `kr-ballad` `kr-dance` `kr-hiphop` `kr-rnb` `trot` `kr-indie` `kr-pop-acoustic` `pop` `hiphop` `rnb` `electronic` `ost` `classic` `newage` `kids` `jpop` `ccm` · `rising`(라이징 아티스트) 중 여러 개 |
| `maxResults` | 차트·검색어마다 최대 결과 수 (기본 100, 일간 종합은 250위까지) |
| `includeSongDetails` | 곡 상세 추가: 장르·크레딧·뮤직비디오 (곡 상세 이벤트 요금) |
| `searchKeywords` | 곡 검색어 |
| `songs`, `albums`, `artists` | FLO ID 또는 music-flo.com 링크 |
| `maxSongsPerArtist`, `artistSongOrder` | 아티스트 곡 목록 수(0 = 정보만)와 정렬(인기순·최신순) |

#### 📤 출력 예시

주간 종합 차트 1위 + 곡 상세 (실제 실행 결과, 참여 정보 일부 생략):

```json
{
  "type": "song",
  "source": "chart",
  "chartKey": "week",
  "chartId": 3,
  "chartName": "주간 종합 차트",
  "chartType": "weekly",
  "chartPeriodStart": "2026-10-26T00:00:00+09:00",
  "chartPeriodEnd": "2026-11-02T23:59:59+09:00",
  "rank": 1,
  "rankChange": 3,
  "isNew": false,
  "chartScore": 107857,
  "songId": "611656860",
  "title": "NEON",
  "artist": "A2O LITE, A2O",
  "artistId": "414956759",
  "artists": [{ "artistId": "414956759", "name": "A2O LITE" }, { "artistId": "412835661", "name": "A2O" }],
  "albumId": "464803660",
  "albumTitle": "NEON",
  "albumType": "싱글",
  "releaseDate": "2026-10-13",
  "duration": "03:28",
  "durationSeconds": 208,
  "isTitleTrack": true,
  "isAdult": false,
  "hasFlac": false,
  "isStreamable": true,
  "imageUrl": "https://cdn.music-flo.com/image/v2/album/660/803/64/04/464803660_18dc7301ad736204_s.jpg?1791433204682/dims/resize/500x500/quality/90",
  "songUrl": "https://www.music-flo.com/detail/track/611656860/details",
  "detailsScraped": true,
  "genre": "댄스팝",
  "serviceStart": "2026-10-13T18:00:00+09:00",
  "lyricists": ["Dem Jointz", "YOO YOUNG JIN"],
  "composers": ["Dem Jointz", "YOO YOUNG JIN"],
  "arrangers": ["Dem Jointz", "YOO YOUNG JIN"],
  "credits": [{ "role": "뮤지션", "name": "A2O LITE" }, { "role": "작사", "name": "Dem Jointz" }, "…"],
  "hasMusicVideo": true,
  "musicVideo": { "videoId": "400132003", "title": "NEON", "type": "MV", "duration": "03:43", "releaseDate": "2026-10-13", "rating": "전체" },
  "scrapedAt": "2026-10-31T12:09:27+00:00"
}
```

라이징 아티스트 · 앨범 · 아티스트 · 아티스트 곡 (요약):

```json
{ "type": "artist", "source": "chart", "chartName": "라이징 아티스트", "rank": 2, "rankChange": 3, "isSoaring": false,
  "risingReasons": ["청취량 상승세"], "artistId": "80267940", "name": "신예영" }
{ "type": "album", "albumId": "464803660", "title": "NEON", "artist": "A2O LITE, A2O", "albumType": "싱글", "releaseDate": "2026-10-13",
  "genre": "댄스팝", "distributor": "(주)지니뮤직", "labels": ["A2O Entertainment"], "trackCount": 1,
  "tracks": [{ "discNo": 1, "trackNo": 1, "songId": "611656860", "title": "NEON", "duration": "03:28", "isTitleTrack": true }] }
{ "type": "artist", "artistId": "80049126", "name": "아이유 (IU)", "gender": "여성", "activityType": "솔로",
  "genre": "팝,댄스팝,어쿠스틱팝,발라드,알앤비,팝록", "currentChartRank": 69 }
{ "type": "song", "source": "artist", "rank": 2, "title": "밤편지", "artist": "아이유 (IU)", "popularity": 27821200, "releaseDate": "2017-03-24" }
```

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

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

| 이벤트 | 가격 | 무료 (매달) |
|---|---|---|
| 곡·차트 항목 (차트·검색·아티스트 목록의 곡 1개, 라이징 아티스트 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원) | – |

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

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

- **기획사·A\&R**: 신곡의 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) · [바이브](https://apify.com/k-data-lab/vibe-scraper) 차트 스크래퍼와 같은 시각에 돌려 플랫폼별 순위를 비교 (올킬 체크). 다섯 액터 모두 `rank` · `title` · `artist` · `songId` 필드 이름이 같아 합치기 쉽습니다.
- **AI 에이전트·챗봇**: "지금 FLO 1위 곡은?" 같은 질문에 최신 데이터로 답하기 (Apify MCP).

#### 🔌 API · 연동

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

```python
from apify_client import ApifyClient

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

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 `flo-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/flo-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/flo-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/flo-scraper",
  "headers": {"Authorization": "Bearer <YOUR_APIFY_TOKEN>"}
}}}
```

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

- "Get today's FLO chart TOP100 and list the 10 songs that climbed the most."
- "Fetch the FLO Korean ballad and hip-hop genre charts and show which artists appear in both."
- "Look up IU's top 20 songs on FLO with their popularity scores."
- "FLO 차트 TOP100 가져와서 1위부터 10위까지 차트 점수랑 같이 표로 보여줘."

#### ❓ 자주 묻는 질문

**지난 날짜의 차트도 되나요?** 아니요. FLO는 현재 게시 중인 차트만 공개합니다. **Schedules**로 매시간·매일 실행하면 그때부터 기록이 쌓입니다. 지난 날짜 차트가 꼭 필요하면 [바이브](https://apify.com/k-data-lab/vibe-scraper)(2011년~ 날짜별)·[벅스](https://apify.com/k-data-lab/bugs-scraper)·[지니](https://apify.com/k-data-lab/genie-scraper) 스크래퍼가 지원합니다.

**`chartScore`는 무엇인가요?** FLO가 차트 순위를 매길 때 쓰는 곡별 점수입니다. 같은 차트 안에서 곡끼리 비교하거나, 같은 곡의 시간별 변화를 볼 때 쓰세요. 차트마다 집계 기간이 달라 서로 다른 차트끼리 점수를 직접 비교하지는 마세요.

**`popularity`는 왜 일부 곡에만 있나요?** FLO는 인기 지수를 아티스트 곡 목록에서만 공개합니다. `artists`로 조회한 곡에 들어 있습니다.

**좋아요 수나 재생수는요?** FLO는 곡별 좋아요 수·재생수를 공개하지 않습니다. 공개된 지표(순위, 차트 점수, 인기 지수)를 드립니다. 재생수·청취자수가 필요하면 [지니 차트 스크래퍼](https://apify.com/k-data-lab/genie-scraper), 좋아요 수는 [멜론 차트 스크래퍼](https://apify.com/k-data-lab/melon-scraper)를 쓰세요.

**가사도 가져오나요?** 아니요. 가사는 저작권이 있는 콘텐츠라 넣지 않습니다. 대신 작사·작곡·편곡과 전체 참여 정보를 드립니다.

**검색 결과 수가 FLO에 표시된 숫자보다 적어요.** FLO 검색 페이지끼리 같은 곡이 겹쳐 나오는 경우가 있어 중복을 제거합니다. 예: "아이유" 검색은 FLO 표시 951곡 중 중복을 뺀 920곡을 모두 가져옵니다.

**크레딧이 비어 있는 곡이 있어요.** FLO가 작사·작곡 정보를 등록하지 않은 곡(주로 클래식·해외·오래된 곡)입니다. FLO에 있는 정보는 모두 가져옵니다.

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

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

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

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

- [멜론 차트·곡·앨범 스크래퍼 (Melon Chart API)](https://apify.com/k-data-lab/melon-scraper): 멜론 TOP100·HOT100·장르 차트와 좋아요 수
- [지니뮤직 차트·곡·앨범 스크래퍼 (Genie Music Chart API)](https://apify.com/k-data-lab/genie-scraper): 지니 TOP200과 곡별 재생수·청취자수
- [벅스 차트·곡·앨범 스크래퍼 (Bugs Music Chart API)](https://apify.com/k-data-lab/bugs-scraper): 벅스 TOP100·장르 29개·지난 차트와 좋아요·크레딧
- [바이브 차트·곡·앨범 스크래퍼 (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): 내 브랜드의 아마존 리뷰 전체를 Seller Central에서 내보내기·모니터링
- [통합 음원차트 API (Korean Music · K-pop Chart)](https://apify.com/k-data-lab/korean-music-chart-scraper): 멜론·지니·벅스·FLO·VIBE 차트를 한 번에, 올킬 판정
- [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 아파트 시세·실거래가
- [TikTok Scraper API](https://apify.com/k-data-lab/tiktok-scraper): 틱톡 영상 통계·자막·프로필, 로그인 불필요
- [YouTube Scraper API](https://apify.com/k-data-lab/youtube-scraper): 유튜브 영상·채널·검색, 로그인 불필요
- [X (Twitter) Tweet Scraper API](https://apify.com/k-data-lab/x-tweet-scraper): 트윗 좋아요·답글·미디어, 로그인 불필요
- [Telegram Scraper API](https://apify.com/k-data-lab/telegram-channel-scraper): 텔레그램 채널·키워드 검색, 로그인 불필요
- [Google Maps Scraper API](https://apify.com/k-data-lab/google-maps-scraper): 구글 지도 장소·전화번호·평점
- [Uber Eats & Deliveroo Scraper API](https://apify.com/k-data-lab/uber-eats-deliveroo-scraper): 메뉴·가격
- [Airline Award Seat Scraper API](https://apify.com/k-data-lab/airline-award-seat-scraper): 항공 마일리지 좌석·세금·잔여석

#### 💬 문의

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

***

#### English summary

**FLO Music Chart Scraper API**: scrape FLO (플로), one of Korea's major music streaming services, without login. You get the FLO Chart TOP100 (last 24 hours, updated hourly), the daily overall **TOP250**, the weekly TOP100, **17 daily genre charts** (Korean ballad, dance, hip-hop, R\&B, trot, indie, pop, foreign pop/hip-hop/R\&B/electronic, OST, J-POP, classical, CCM, …) and the **Rising Artists TOP100** with FLO's rising reasons. Every chart song comes with FLO's own **chart score**, rank change and new-entry flag; artist song lists include FLO's **popularity index**. **Song details** add genre, service start time, lyricists/composers/arrangers, full credits and music-video info. You also get song search (deduplicated, up to 2,000 per keyword), albums (type, distributor, labels, release date, tracklist) and artists (gender, type, genre, current chart rank, 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 FLO actor on the Apify Store. Unofficial, not affiliated with FLO / Dreamus. No lyrics, no user data. FLO publishes current charts only (no past dates).

Tags: flo chart, flo music scraper, flo api, music-flo, 플로 차트, 플로 크롤링, kpop chart, k-pop chart api, korean music chart, korean music chart api, k-pop chart data, 음원 차트, 케이팝 차트

# Actor input Schema

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

FLO chart IDs to fetch; pick several. Example: \["flo"] = FLO Chart TOP100 (last 24 h, updated hourly); \["day", "kr-ballad"] = daily overall TOP250 + Korean ballad TOP100. "week" = weekly TOP100; genre IDs (kr-ballad, kr-dance, kr-hiphop, kr-rnb, trot, kr-indie, kr-pop-acoustic, pop, hiphop, rnb, electronic, ost, classic, newage, kids, jpop, ccm) are daily TOP100s; "rising" = Rising Artists TOP100 (artists, not songs). Every song row has rank, rankChange and FLO chartScore. FLO publishes current charts only (no past dates): schedule daily runs to build history. Leave empty to skip charts. / 가져올 FLO 차트 (여러 개 선택). FLO 차트 = 최근 24시간·매시 갱신, 일간 종합 = TOP250, 장르 17개 = 매일 TOP100, rising = 라이징 아티스트. 지난 날짜 차트는 없습니다.

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

Max songs per chart or per search keyword. Example: 100 = full TOP100, 10 = top 10 only (cheapest test). Daily overall goes to 250, other charts to 100, search to 2,000. / 차트·검색어마다 최대 곡 수.

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

Adds genre, service start time, lyricist/composer/arranger, full credits and music-video info to every chart, search and artist song (extra "song details" event per song). No lyrics (copyright). Example: true if you need songwriters or genres, false (default) for ranks only. / 장르·작사·작곡·편곡·뮤직비디오 추가 (곡 상세 요금 추가).

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

Search FLO songs by keyword, in Korean or English (artist, title). Example: \["아이유", "aespa"]. Results come in FLO relevance order, up to Max results per keyword, deduplicated. Leave empty to skip. / FLO 곡 검색어 (예: 아이유, 에스파, 밤양갱).

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

FLO song IDs or music-flo.com track links. Example: "611656860" or "https://www.music-flo.com/detail/track/611656860/details". Always includes song details (song + song details events). Leave empty to skip. / FLO 곡 ID 또는 링크.

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

FLO album IDs or links. Example: "464803660" or "https://www.music-flo.com/detail/album/464803660/albumtrack". One row per album: type, release date, genre, distributor, labels, description and full tracklist. Leave empty to skip. / FLO 앨범 ID 또는 링크.

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

FLO artist IDs or links. Example: "80049126" (IU / 아이유) or "https://www.music-flo.com/detail/artist/80049126/track". Returns artist info plus their songs, each with FLO popularity index. Leave empty to skip. / FLO 아티스트 ID 또는 링크.

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

How many songs to fetch per artist (0 = artist info only). Example: 50 = top 50 songs, 0 = profile only. Used only when Artists is set. / 아티스트마다 가져올 곡 수.

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

Order of each artist's song list: "popular" (default, most popular first) or "latest" (newest releases first). / 인기순 또는 최신순.

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

Usually not needed: leave the default. If FLO refuses a direct request, the actor retries through Apify Proxy automatically. Example: {"useApifyProxy": false}. / 보통 필요 없습니다.

## Actor input object example

```json
{
  "charts": [
    "flo"
  ],
  "maxResults": 100,
  "includeSongDetails": false,
  "searchKeywords": [],
  "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": [
        "flo"
    ],
    "maxResults": 100,
    "searchKeywords": [],
    "songs": [],
    "albums": [],
    "artists": []
};

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

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

```

## MCP server setup

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