---
title: "A&R Artists by Playlists"
method: GET
path: "/api/artist/anr/by/playlists"
tags: ["Artist"]
---

# A&R Artists by Playlists

`GET /api/artist/anr/by/playlists`

## Request

- Base URL: `https://api.chartmetric.com`
- URL: `https://api.chartmetric.com/api/artist/anr/by/playlists`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/chartmetric/apis/chartmetric-developer-api/docs/api/artist/anr/by/playlists/get.ts> (a function with typed inputs; its response is checked against the schema)

A&R-oriented artist snapshot sorted by Spotify playlist-count growth. Hydrated from the `cm_artist_cache` ES index; per-artist releases come from the earliest/latest album query.

## Query parameters

- `limit` integer: Maximum number of artists to return. Defaults to 10, max 100.
- `sortBy` 'followers_total_reach_diff_week_percent' | 'followers_total_reach_diff_week', required: Column to sort by. One of `followers_total_reach_diff_week_percent`, `followers_total_reach_diff_week`.

## Response `200`

Success

- object
  - `obj` object[], required
    - `rank` union: 1-based position of the artist within the sorted result set.
      - integer
      - string
    - `id` integer, nullable: Chartmetric artist ID.
    - `name` string, nullable: Artist name.
    - `image_url` string, nullable: Artist image URL.
    - `code2` string, nullable: Artist country (ISO 3166-1 alpha-2).
    - `sp_followers` integer, nullable: Spotify follower count.
    - `sp_popularity` integer, nullable: Spotify popularity score (0–100).
    - `sp_monthly_listeners` integer, nullable: Spotify monthly listener count.
    - `deezer_fans` union: Deezer fan count. May arrive as string (uncast aggregate).
      - number, float
      - string
    - `tags` unknown[], nullable: List of artist genre tags.
      - unknown
    - `spotify_artist_ids` string[], nullable: Spotify artist IDs linked to this Chartmetric artist.
    - `cm_artist_rank` integer, nullable: Chartmetric overall artist rank.
    - `cm_artist_score` number, float, nullable: Chartmetric artist score (0–100).
    - `num_tracks` integer, nullable: Number of tracks featured in playlists for this artist.
    - `num_playlists` integer, nullable: Number of playlists featuring this artist.
    - `num_playlists_diff_week` integer, nullable: Weekly change in playlist count (vs 7 days ago).
    - `num_playlists_diff_week_percent` number, float, nullable: Weekly percentage change in playlist count.
    - `followers_total_reach` integer, nullable: Sum of follower counts across all playlists featuring this artist.
    - `followers_total_reach_diff_week` integer, nullable: Weekly change in total playlist follower reach.
    - `followers_total_reach_diff_week_percent` number, float, nullable: Weekly percentage change in total playlist follower reach.
    - `popularity` integer, nullable: Spotify popularity score (0–100, higher is more popular).
    - `popularity_diff_week` integer, nullable: Weekly change in Spotify popularity.
    - `popularity_diff_week_percent` number, float, nullable: Weekly percentage change in Spotify popularity.
    - `followers` integer, nullable: Spotify follower count.
    - `followers_diff_week` integer, nullable: Weekly change in Spotify follower count.
    - `followers_diff_week_percent` number, float, nullable: Weekly percentage change in Spotify follower count.
    - `listeners` integer, nullable: Spotify monthly listener count.
    - `listeners_diff_week` integer, nullable: Weekly change in Spotify monthly listeners.
    - `listeners_diff_week_percent` number, float, nullable: Weekly percentage change in Spotify monthly listeners.
    - `timestp` union: Timestamp for the snapshot (ISO 8601).
      - string
      - string, date-time
    - `releases` object[], nullable: List of the artist's earliest and latest album releases.
      - `cm_album` integer, nullable: Chartmetric album ID.
      - `album_name` string, nullable: Album name.
      - `release_date` union: Album release date (ISO 8601).
        - string
        - string, date-time
      - `upc` string, nullable: Universal Product Code identifying the release.
      - `label` string, nullable: Record label that released the album.
      - `image_url` string, nullable: Album cover image URL.
    - `genres` unknown[], nullable: List of genres for the artist.
      - unknown
    - `authenticity_risk` unknown

---

[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)