SoundCloud Charts (Legacy)

​

Legacy SoundCloud charts (deprecated by SoundCloud but retained). Handler runs QUERY_GET_SOUNDCLOUD_CHARTS (or ..._RAW when raw=true), merges track metadata, and attaches historical rankStats. A nested soundcloud_user object is passed through unmodified.

Query Parameters
  • country_code
    Type: string
    min length:  
    2
    max length:  
    6    enum
    required
    values
    • IE
    • AU
    • NL
    • CA
    • GLOBAL
  • kind
    Type: stringenum
    required
    values
    • top
    • trending
  • genre
    Type: stringenum
    required
    values
    • soundtrack
    • world
    • latin
    • triphop
    • danceedm
  • date
    Type: stringFormat: date-time

    the date-time notation as defined by RFC 3339, section 5.6, for example, 2017-07-21T17:32:28Z

  • offset
    Type: integer
    min:  
    0

    Integer numbers.

  • raw
    Type: boolean
  • chart_type
    Type: stringenum
    values
    • trending
    • track
  • latest
    Type: boolean
Responses
  • application/json
Request Example for get/api/charts/soundcloud
curl 'https://api.chartmetric.com/api/charts/soundcloud?country_code=IE&kind=top&genre=soundtrack&date=&offset=0&raw=true&chart_type=track&latest=true' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "length": null,
    "data": [
      {
        "id": 0,
        "name": null,
        "isrc": null,
        "image_url": null,
        "description": null,
        "tags": null,
        "cm_track": 0,
        "cm_artist": [
          0
        ],
        "artist_names": [
          null
        ],
        "code2s": [
          null
        ],
        "artist_images": [
          null
        ],
        "artist_covers": [
          null
        ],
        "spotify_track_ids": [
          null
        ],
        "spotify_album_ids": [
          null
        ],
        "spotify_duration_ms": null,
        "itunes_track_ids": [
          null
        ],
        "itunes_album_ids": [
          null
        ],
        "itunes_artist_ids": [
          1
        ],
        "itunes_artist_names": [
          null
        ],
        "storefronts": [
          null
        ],
        "deezer_track_ids": [
          null
        ],
        "deezer_album_ids": [
          1
        ],
        "deezer_duration": null,
        "amazon_track_ids": [
          null
        ],
        "amazon_album_ids": [
          null
        ],
        "album_ids": [
          0
        ],
        "album_names": [
          null
        ],
        "album_upc": [
          null
        ],
        "album_label": [
          null
        ],
        "release_dates": [
          "2026-05-06T23:20:37.240Z"
        ],
        "created_at": "2026-05-06T23:20:37.240Z",
        "modified_at": "2026-05-06T23:20:37.240Z",
        "rank": null,
        "pre_rank": null,
        "peak_rank": null,
        "peak_date": "2026-05-06T23:20:37.240Z",
        "added_at": "2026-05-06T23:20:37.240Z",
        "velocity": null,
        "time_on_chart": "string",
        "country": null,
        "genre": null,
        "kind": null,
        "soundcloud_track_id": "string",
        "playcount_all": "string",
        "playcount_weekly": "string",
        "artwork_url": null,
        "permalink_url": null,
        "public": null,
        "publisher": null,
        "writer_composer": null,
        "artist": null,
        "album_title": null,
        "soundcloud_user": {},
        "rankStats": [
          {
            "rank": null,
            "timestp": "2026-05-06T23:20:37.240Z"
          }
        ]
      }
    ]
  }
}

Success