Melon Track Chart

Return Melon track chart entries (historical positions, streaming trend, hydrated artist/album metadata). Served by the CCC (cm_chart_cache_v2) pipeline via Charts.getChartsFromCH. chartType accepts general, k-pop, pop, others, top, hot. top and hot are single charts with no genre / duration filters.

Path Parameters

chartType
Type: stringenum
required

Melon track chart type (e.g. general, k-pop, pop, others, top, hot). top/hot are single charts and ignore genre/duration.

values
generalpopk-popotherstophot

Query Parameters

date
Type: stringFormat: date

Date for the chart slice (YYYY-MM-DD). Required unless latest=true.
latest
Type: boolean

If true, use the most recently available chart date and ignore date.
limit
Type: integer
min:
1

Maximum number of items to return per request.
offset
Type: integer
min:
0

Number of items to skip from the start of the result set; pair with limit to paginate.
code2

ISO 3166-1 alpha-2 country code (uppercase, e.g. 'US') or 'GLOBAL'. When omitted, the platform's default chart scope applies.
Type: string
min length:
2
max length:
2

ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').
duration
Type: stringenum
required

Chart duration window. One of daily, monthly, weekly, yearly, semi-yearly, real-time, all_time.

values
dailymonthlyweeklyyearlysemi-yearlyreal-timeall_time
genre
Type: string
max length:
100
required

Genre filter for the chart slice. Lowercased and trimmed.
cityId
Type: integer
min:
0
max:
2147483647

Chartmetric city ID to scope the chart to a city.

Responses

application/json

get/api/charts/melon/track/{chartType}

curl 'https://api.chartmetric.com/api/charts/melon/track/general?latest=false&limit=100&duration=daily&genre=example' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": [
    {
      "entityId": 144447279,
      "targetId": "38626852",
      "duration": "daily",
      "country": "",
      "cityId": 0,
      "genre": "All Genres",
      "rank": 1,
      "rankDiff": 0,
      "rankTrend": [
        {
          "timestp": "2025-05-28",
          "rank": "1"
        },
        {
          "timestp": "2025-05-29",
          "rank": "1"
        }
      ],
      "peakDate": "2025-05-11",
      "peakRank": 1,
      "velocity7Day": 0,
      "periodsOnChart": 85,
      "consecutivePeriods": 85,
      "chartedDate": "2025-05-30",
      "name": "To Reach You (Inst.)",
      "imageUrl": "https://i.scdn.co/image/ab67616d0000b27358c6956da5fa380b67986551",
      "createdAt": "2025-06-03T07:24:14.000Z",
      "artists": [
        {
          "careerStage": "mainstream",
          "code2": "KR",
          "id": 217578,
          "name": "10CM",
          "imageUrl": "https://i.scdn.co/image/ab6761610000e5eb2445af13cb1a8132388cd566"
        }
      ],
      "album": {
        "id": 42895219,
        "name": "To Reach You",
        "label": "CAM",
        "releaseDate": "2025-03-06T00:00:00.000Z"
      },
      "optionalRows": {
        "overallRank": 0,
        "metricValue": 0,
        "metricDiff": null,
        "score": 0,
        "isComeback": false,
        "plays": 0
      },
      "targetExtras": {
        "melonComments": 698,
        "melonLikes": 114826,
        "spotifyPopularity": 30
      },
      "isChartGenre": true
    }
  ]
}

Success

Twitch User Charts

Hanteo Chart