Get YouTube Shorts Chart

​

Return the YouTube Shorts chart for chartType (shorts_daily / shorts_weekly) and code2. Uses the CCC cm_chart_cache_v2 pipeline (Charts.getChartsFromCH with platform: "youtube", chartEntity: "track") and returns a bare array under obj.

Path Parameters
  • chartType
    Type: string enum
    required

    YouTube Shorts chart type (shorts_daily or shorts_weekly).

    values
    • shorts_daily
    • shorts_weekly
Query Parameters
  • code2
    required

    ISO 3166-1 alpha-2 country code (uppercase, e.g. 'US') or the literal 'GLOBAL' for cross-country charts.

    • Type: string
      min length:  
      2
      max length:  
      2

      ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

  • date
    Type: string Format: date-time

    Date for the time-slice (YYYY-MM-DD). Required unless latest=true.

  • latest
    Type: boolean

    If true, use the most recently available date and ignore date.

  • limit
    Type: integer
    min:  
    1
    max:  
    1000

    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.

Responses
  • application/json
Request Example for get/api/charts/youtube/shorts/{chartType}
curl 'https://api.chartmetric.com/api/charts/youtube/shorts/shorts_daily?code2=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "entityId": 27599255,
      "targetId": "uLHqpjW3aDs",
      "name": "Roddy Ricch - The Box [Official Audio]",
      "rank": 1,
      "chartedDate": "2026-02-06",
      "country": "US",
      "imageUrl": null,
      "rankDiff": 0,
      "artists": [
        {
          "id": 839964,
          "name": "Roddy Ricch",
          "code2": "US",
          "imageUrl": null,
          "careerStage": "mainstream"
        }
      ],
      "album": {
        "id": null,
        "name": "The Box",
        "label": null,
        "releaseDate": null
      },
      "isrc": "USAT21906978",
      "externalId": "uLHqpjW3aDs",
      "targetExtras": {
        "youtubeViews": 20500000
      },
      "genre": "hip-hop/rap",
      "isChartGenre": false
    }
  ]
}

Success