List Top Tracks in a City

Top tracks in a city for a given platform (domain in youtube | shazam | radio). Each item merges per-platform stats with basic track metadata (cm_track, artists, album info, genre tags). position_stats is only populated when domain=shazam. count is surfaced as a string when the underlying aggregate returns a BIGINT.

Path Parameters

id
Type: integer
min:
0
max:
2147483647
required

Chartmetric city ID.
domain
Type: string enum
required

Platform whose audience signal ranks the tracks (one of youtube | shazam | radio).
values
- youtube
- radio
- shazam

Responses

application/json

get/api/city/{id}/{domain}/top-tracks

curl https://api.chartmetric.com/api/city/0/youtube/top-tracks \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "obj": [
    {
      "isrc": "DEA629252500",
      "count": "28",
      "position_stats": [
        {
          "timestp": "2020-08-03",
          "position": 81
        },
        {
          "timestp": "2020-08-04",
          "position": 58
        }
      ],
      "id": 11291890,
      "name": "Major Tom",
      "image_url": "https://i.scdn.co/image/73b7f1f27769379d6796ed9300bda12d9dd3e75d",
      "description": null,
      "created_at": null,
      "modified_at": "2020-07-03T05:29:55.573Z",
      "tags": "Pop,Soundtrack,Soundtrack,Music,Pop",
      "cm_track": 11291890,
      "cm_artist": [
        217598
      ],
      "artist_names": [
        "Peter Schilling"
      ],
      "code2s": [
        "DE"
      ],
      "artist_images": [
        "https://i.scdn.co/image/3f6870676468c6f14dff7df4a7a0cc57c604e258"
      ],
      "artist_covers": [
        null
      ],
      "artists": [
        {
          "id": 217598,
          "name": "Peter Schilling"
        }
      ],
      "spotify_track_ids": [
        "6lXKNdOsnaLv9LwulZbxNl"
      ],
      "spotify_album_ids": [
        "1rYXSHYaxxQ9HclnAeVhxv"
      ],
      "spotify_duration_ms": 300266,
      "itunes_track_ids": [
        "40633230"
      ],
      "itunes_album_ids": [
        "40633214"
      ],
      "storefronts": [
        "US"
      ],
      "deezer_track_ids": [
        "520450102"
      ],
      "deezer_album_ids": [
        67074482
      ],
      "deezer_duration": 299,
      "amazon_track_ids": null,
      "amazon_album_ids": null,
      "album_ids": [
        473527
      ],
      "album_names": [
        "SWR1 - Achtzig 80er"
      ],
      "album_upc": [
        "5099969886652"
      ],
      "album_label": [
        "EMM"
      ],
      "release_dates": [
        "2009-06-19T07:00:00.000Z"
      ]
    }
  ]
}

Success