SoundCloud Track Chart

​

Return the new SoundCloud track chart entries (deprecates the legacy /charts/soundcloud endpoint). SoundCloud now only publishes chart data for US and UK. Rows include isrc, externalId, optionalFields (vs optionalRows on other platforms), and entityGenre.

Path Parameters
  • chartType
    enum
    const:  
    top
    required

    SoundCloud chart type; only top is currently published.

    values
    • top
Query Parameters
  • code2
    required

    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').

  • genre
    Type: string
    max length:  
    100
    required

    Chart genre. Use /api/charts/genres/soundcloud?code2={code2} to retrieve available genres for a country.

  • 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

    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/soundcloud/track/{chartType}
curl 'https://api.chartmetric.com/api/charts/soundcloud/track/top?code2=&genre=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "entityId": 153482095,
      "targetId": "2176782261",
      "country": "US",
      "cityId": 0,
      "genre": "all music genres",
      "rank": 1,
      "rankDiff": 2,
      "rankTrend": [
        {
          "timestp": "2025-11-24",
          "rank": "3"
        }
      ],
      "peakDate": "2025-10-30",
      "peakRank": 1,
      "velocity7Day": 0.2857143,
      "periodsOnChart": 57,
      "consecutivePeriods": 57,
      "chartedDate": "2025-11-27",
      "name": "What You Is",
      "imageUrl": "https://is1-ssl.mzstatic.com/image/thumb/Music211/v4/49/28/fc/4928fc53-b49f-5e65-45e9-404eca11726f/25UM1IM51211.rgb.jpg/160x160bb.jpg",
      "createdAt": "2025-11-28T07:23:15.000Z",
      "artists": [
        {
          "careerStage": "superstar",
          "code2": "US",
          "id": 215373,
          "name": "YoungBoy Never Broke Again",
          "imageUrl": "https://i.scdn.co/image/ab6761610000e5eb776e469c846c205685141317"
        }
      ],
      "album": {
        "id": 47470879,
        "name": "What You Is - Single",
        "label": "Never Broke Again, LLC/Motown Records",
        "releaseDate": "2025-09-26T00:00:00.000Z"
      },
      "isrc": "USUG12508898",
      "externalId": "2176782261",
      "optionalFields": {
        "artistName": "YoungBoy Never Broke Again",
        "overallRank": 0,
        "score": 0,
        "isComeback": false,
        "name": "What You Is",
        "imageUrl": "https://i1.sndcdn.com/artworks-GOzyCU2UJ0j8-0-large.jpg",
        "albumName": "What You Is"
      },
      "targetExtras": {
        "soundcloudPlays": 500000
      },
      "isChartGenre": true,
      "entityGenre": "hip hop"
    }
  ]
}

Success