SOUND.RADAR API DEV
NOINDEX Docs

Charts API

Korea Music Charts

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

Overview

What this API is for

This API exposes cached Korean chart data from Melon, Genie, and Bugs. It stores each source and chart type separately in MySQL, then serves site-specific rankings, rank movement display, and one-call comparison by title or artist.

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 cached JSON files.

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/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 service runs from /opt/soundradar-collectors/korea-music-chart on internal port 8050. The timer is korea-chart-refresh.timer and runs every hour at minute 05.