---
title: "List Top Artists in a City"
method: GET
path: "/api/city/{id}/{domain}/top-artists"
tags: ["City"]
---

# List Top Artists in a City

`GET /api/city/{id}/{domain}/top-artists`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/city/{id}/{domain}/top-artists`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/city/:id/:domain/top-artists/get.ts> (a function with typed inputs; its response is checked against the schema)

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` integer, required: Chartmetric city ID.
- `domain` 'spotify' | 'youtube' | 'shazam' | 'radio' | 'instagram', required: Platform whose audience signal ranks the artists (one of `spotify | youtube | shazam | radio | instagram`).

## Response `200`

Success

- object
  - `obj` object[], required
    - `count` union: Local audience signal: `spotify` → monthly listeners; `youtube` → daily views; `instagram` → followers; `shazam`/`radio` → occurrences. May arrive as a string when the aggregate is `BIGINT`.
      - integer
      - string
    - `username` string, nullable: Instagram username of the artist; only populated when `domain=instagram`.
    - `id` integer, required: Chartmetric artist ID.
    - `name` string, nullable: Artist display name.
    - `image_url` string, nullable: URL of the artist profile image.
    - `isni` string, nullable: International Standard Name Identifier (ISNI) of the artist.
    - `code2` string, nullable: ISO 3166-1 alpha-2 country code of the artist's primary country (2 letters, e.g. 'us', 'br').
    - `hometown_city` string, nullable: Artist's hometown city.
    - `current_city` string, nullable: Artist's current city.
    - `verified` boolean, nullable: Whether the artist is verified on the underlying platform.
    - `band` boolean, nullable: True when the artist is a band/group rather than a solo act.
    - `gender` string, nullable: Artist gender label (e.g. 'male', 'female', 'mixed', 'non-binary').
    - `sp_followers` integer, nullable: Spotify follower count.
    - `sp_popularity` integer, nullable: Spotify popularity score (0–100).
    - `sp_monthly_listeners` integer, nullable: Spotify monthly listeners.
    - `deezer_fans` integer, nullable: Deezer fan count.
    - `cm_artist_rank` integer, nullable: Global Chartmetric artist rank (1 is highest).
    - `cm_artist_score` number, float, nullable: Chartmetric artist score (0–100).
    - `primary_genre_smart` union: Primary genre under Chartmetric's smart-genre taxonomy; surfaced as an ID, a name, or a `{id, name}` object depending on the join.
      - integer
      - string
      - object
    - `tags` string[], nullable: Genre tags associated with the artist.
    - `spotify_artist_ids` string[], nullable: Spotify artist IDs linked to this Chartmetric artist.
    - `itunes_artist_ids` integer[], nullable: iTunes/Apple Music artist IDs linked to this Chartmetric artist.
    - `deezer_artist_ids` string[], nullable: Deezer artist IDs linked to this Chartmetric artist.
    - `amazon_artist_ids` string[], nullable: Amazon Music artist IDs linked to this Chartmetric artist.
    - `latest_release` object, nullable: Most recent album release attributed to this artist; `null` when the artist has no release on file.
      - `cm_album` integer, nullable: Chartmetric album ID of the most recent release.
      - `album_name` string, nullable: Album title.
      - `release_date` string, date-time, nullable: Album release date (ISO 8601).
      - `upc` string, nullable: Universal Product Code identifying the release.
      - `label` string, nullable: Record label that released the album.
      - `image_url` string, nullable: URL of the album cover image.

---

[API](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api.md) - [All operations](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/revisions/94dac96833a3?raw)