Hanteo Chart

​

Return Hanteo chart entries for the given entityType (track or album). Shape matches the generic regional CCC chart row; hydrated rows may also expose externalId, id, platform_id, and a physicalRecordIndex inside optionalRows.

Path Parameters
  • entityType
    Type: string enum
    required

    Chart entity (track or album).

    values
    • track
    • album
    • artist
    • video
  • chartType
    Type: string enum
    required

    Hanteo chart type. Allowed values depend on entityType.

    values
    • digital
    • top
    • music
    • world
Query Parameters
  • date
    Type: string Format: 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: string enum
    required

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

    values
    • daily
    • monthly
    • weekly
    • yearly
    • semi-yearly
    • real-time
    • all_time
  • genre
    Type: string
    max length:  
    100

    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
Request Example for get/api/charts/hanteo/{entityType}/{chartType}
curl 'https://api.chartmetric.com/api/charts/hanteo/track/digital?duration=daily' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "entityId": 144447279,
      "targetId": "78",
      "duration": "daily",
      "country": "",
      "cityId": 0,
      "genre": "rock, pop, k-pop",
      "rank": 1,
      "rankDiff": 0,
      "rankTrend": [
        {
          "timestp": "2025-05-31",
          "rank": "1"
        }
      ],
      "peakDate": "2025-05-11",
      "peakRank": 1,
      "velocity7Day": 0,
      "periodsOnChart": 46,
      "consecutivePeriods": 46,
      "chartedDate": "2025-06-03",
      "name": "Song title",
      "imageUrl": "https://i.scdn.co/image/ab67616d0000b27358c6956da5fa380b67986551",
      "createdAt": "2025-06-09T02:20:15.000Z",
      "artists": [
        {
          "careerStage": "mainstream",
          "code2": "KR",
          "id": 217578,
          "name": "10CM",
          "imageUrl": "https://i.scdn.co/image/ab6761610000e5eb2445af13cb1a8132388cd566"
        }
      ],
      "album": {
        "id": 42895219,
        "name": "Album title",
        "label": "CAM",
        "releaseDate": "2025-03-06T00:00:00.000Z"
      },
      "externalId": 1830886,
      "optionalRows": {
        "physicalRecordIndex": "9963.93",
        "label": "CAM",
        "overallRank": 0,
        "score": 0,
        "isComeback": false
      },
      "targetExtras": {
        "spotifyPopularity": 30
      },
      "isChartGenre": false,
      "id": 78,
      "platform_id": 1830886
    }
  ]
}

Success