SOUND.RADAR API DEV
HOME Docs

Charts API

Korea Music Charts

Melon, Genie, Bugs, FLO, and VIBE chart snapshots with hourly refresh, rank changes, and cross-site comparison.

Overview

What this API is for

This API exposes Korean chart signals from Melon, Genie, Bugs, FLO, and VIBE. Each source and chart type is normalized into a consistent SOUND.RADAR response for site-specific rankings, rank movement display, and one-call comparison by title or artist where supported.

Access

Public path and credentials

Basehttps://api.soundradar.co/korea-chart
AuthProtected data endpoints require X-API-Key. Keep keys server-side.
SchemaOpenAPI JSON and Swagger UI are available.

Endpoints

Available routes

GET/korea-chart/health

Public service health, supported sites, and latest available chart snapshots.

GET/korea-chart/sites

Supported source sites. Requires X-API-Key.

GET/korea-chart/charts

Site-specific chart entries with rank_change and rank_status.

siterequiredchart_typelimit
GET/korea-chart/melon/charts/{chart_type}

Melon chart entries. Supported chart types: realtime, hot100_d100, hot100_d30, daily, weekly.

GET/korea-chart/bugs/charts/{chart_type}

Bugs chart entries. Supported chart types: realtime, daily, weekly.

GET/korea-chart/genie/charts/{chart_type}

Genie chart entries. Supported chart types: realtime, daily, weekly.

GET/korea-chart/flo/charts/{chart_type}

FLO chart entries. Supported chart types: all_age, rising, rising_hourly.

GET/korea-chart/vibe/charts/{chart_type}

VIBE chart entries. Supported chart types: daily_top100, domestic_rising, oversea_rising.

GET/korea-chart/charts/compare

Merge Melon, Genie, and Bugs rankings by normalized title and artist. Common chart types are realtime, daily, and weekly.

keywordchart_typelimit
POST/korea-chart/refresh

Manually refresh all sites/chart types or one selected site/chart type. Requires X-API-Key.

sitechart_type

Examples

Requests

curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/korea-chart/melon/charts/hot100_d100?limit=10"
curl -H "X-API-Key: $SOUND_RADAR_API_KEY" \
  "https://api.soundradar.co/korea-chart/charts/compare?chart_type=daily&keyword=IVE&limit=10"

Operations

Runtime notes

The Korea chart channel refreshes hourly and keeps Melon, Genie, Bugs, FLO, and VIBE snapshots aligned behind the public /korea-chart contract.