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:
6enum
required

Country code accepted by the legacy SoundCloud chart pipeline; only the values supported by SoundCloud are valid.
values
- IE
- AU
- NL
- CA
- GLOBAL
kind
Type: stringenum
required

SoundCloud chart kind (e.g. trending, top).
values
- top
- trending
genre
Type: stringenum
required

SoundCloud genre filter; values are lowercased. See CONSTANTS.SOUNDCLOUD_CHART_GENRES for the supported list.
values
- soundtrack
- world
- latin
- triphop
- danceedm
date
Type: stringFormat: date-time

Date for the time-slice (YYYY-MM-DD). Required unless latest=true.
offset
Type: integer
min:
0

Number of items to skip from the start of the result set; pair with limit to paginate.
raw
Type: boolean

If true (default), exclude peak_rank/peak_date for faster response. Set to false to include peak fields.
chart_type
Type: stringenum

Source SoundCloud chart table: trending or track. Defaults to track.
values
- trending
- track
latest
Type: boolean

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

Responses

application/json

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'

Show Schema

{
  "obj": {
    "length": null,
    "data": [
      {
        "id": 0,
        "name": null,
        "isrc": null,
        "image_url": null,
        "description": null,
        "tags": null,
        "cm_track": null,
        "cm_artist": [
          null
        ],
        "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-06-19T06:30:35.300Z"
        ],
        "created_at": "2026-06-19T06:30:35.300Z",
        "modified_at": "2026-06-19T06:30:35.300Z",
        "rank": null,
        "pre_rank": null,
        "peak_rank": null,
        "peak_date": "2026-06-19T06:30:35.300Z",
        "added_at": "2026-06-19T06:30:35.300Z",
        "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": {
          "id": null,
          "kind": null,
          "username": null,
          "permalink": null,
          "permalink_url": null,
          "uri": null,
          "urn": null,
          "first_name": null,
          "last_name": null,
          "full_name": null,
          "description": null,
          "avatar_url": null,
          "city": null,
          "country_code": null,
          "verified": null,
          "visuals": null,
          "create_at": null,
          "last_modified": null,
          "followers_count": null,
          "followings_count": null,
          "comments_count": null,
          "groups_count": null,
          "likes_count": null,
          "playlist_likes_count": null,
          "playlist_count": null,
          "reposts_count": null,
          "track_count": null,
          "creator_subscriptions": [
            {
              "product": {}
            }
          ],
          "badges": {
            "pro_unlimited": null,
            "verified": null
          }
        },
        "rankStats": [
          {
            "rank": null,
            "timestp": "2026-06-19T06:30:35.300Z"
          }
        ]
      }
    ]
  }
}

Success