List Top Artists in a City

Top artists in a city for a given platform (domain in spotify | youtube | shazam | radio | instagram). Each item merges per-platform stats (count, and username when domain=instagram) with basic artist info (IDs, audience stats, genre tags, latest release). 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 artists (one of spotify | youtube | shazam | radio | instagram).
values
- spotify
- youtube
- shazam
- radio
- instagram

Responses

application/json

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

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

Show Schema

{
  "obj": [
    {
      "count": "258",
      "id": 1401297,
      "name": "Pop Smoke",
      "image_url": "https://i.scdn.co/image/8f0a45ff4868c7868a7996b57da64f2e89042e26",
      "isni": null,
      "code2": "us",
      "hometown_city": null,
      "current_city": null,
      "verified": false,
      "band": false,
      "gender": null,
      "sp_followers": 1374300,
      "sp_popularity": 95,
      "sp_monthly_listeners": 27687238,
      "deezer_fans": 181349,
      "cm_artist_rank": 37,
      "cm_artist_score": 92.4,
      "primary_genre_smart": 501121,
      "tags": [
        "rap"
      ],
      "spotify_artist_ids": [
        "0eDvMgVFoNV3TpwtrVCoTj"
      ],
      "itunes_artist_ids": [
        1450601383
      ],
      "deezer_artist_ids": [
        "58447102"
      ],
      "amazon_artist_ids": [
        "B07N6R3268"
      ],
      "latest_release": {
        "cm_album": 6591557,
        "album_name": "今は亡きあの人たち",
        "release_date": "2020-08-19T07:00:00.000Z",
        "upc": "602435142609",
        "label": "UMG Recordings, Inc.",
        "image_url": "https://i.scdn.co/image/ab67616d0000b27349066d2258ad2e46955e2381"
      }
    }
  ]
}

Success