---
title: "A&R Artists by Social Index"
method: GET
path: "/api/artist/anr/by/social-index"
tags: ["Artist"]
---

# A&R Artists by Social Index

`GET /api/artist/anr/by/social-index`

## Request

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

A&R-oriented artist snapshot sorted by social / streaming growth metric. `sortBy` selects which service-type fields are hydrated and returned alongside `weekInsights` (7-day), `insights` (30-day), and `twoMonthInsights` (60-day) growth objects. External API forces `interval=monthly`.

## Query parameters

- `offset` integer: Number of items to skip from the start of the result set; capped so `limit + offset` does not exceed 10,000 (Elasticsearch max window).
- `limit` integer: Maximum number of artists to return. Defaults to 10, max 100.
- `sortBy` 'spotify_popularity' | 'spotify_followers' | 'spotify_monthly_listeners' | 'facebook_likes' | 'twitter_followers' | 'instagram_followers' | 'tiktok_followers' | 'wiki_views' | 'soundcloud_followers' | 'youtube_channel_views', required: Metric to sort by. One of `spotify_popularity`, `spotify_followers`, `spotify_monthly_listeners`, `facebook_likes`, `twitter_followers`, `instagram_followers`, `tiktok_followers`, `wiki_views`, `soundcloud_followers`, `youtube_channel_views`. `facebook_likes` is internally remapped to `fs_likes`.
- `tagIds` integer: Optional parent genre ID to restrict the result set.
- `subTagIds` integer: Optional child genre ID. Deprecated and has no effect on the model — kept for backwards compatibility.
- `code2` string: ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').
- `sortOrderDesc` boolean: If true (default), sort descending by `sortBy`.
- `minThirtyDayGrowth` integer: Minimum 30-day growth threshold for `sortBy`.
- `maxThirtyDayGrowth` integer: Maximum 30-day growth threshold for `sortBy`.
- `minSpotifyFollowers` integer: Minimum Spotify followers filter. Defaults to -1 (no minimum).
- `maxSpotifyFollowers` integer: Maximum Spotify followers filter. Defaults to -1 (no maximum).
- `recentReleaseWithin` integer: Restrict to artists whose first release is within this many days of today. Defaults to 2555 (~7 years).
- `latestReleaseWithin` integer: Restrict to artists whose latest release is within this many days of today. Defaults to 60.
- `unsigned` boolean: If true (default), restrict the result set to unsigned artists.

## Response `200`

Success

- object
  - `obj` object[], required
    - `id` union: Chartmetric artist ID. May arrive as string from ES.
      - integer
      - string
    - `name` string, nullable: Artist name.
    - `code2` string, nullable: Artist country (ISO 3166-1 alpha-2).
    - `image_url` string, nullable: Artist image URL.
    - `tags` string[], nullable: List of artist genre tags.
    - `spotify_artist_ids` string[], nullable: Spotify artist IDs linked to this Chartmetric artist.
    - `releases` object[], nullable: List of the artist's recent 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.
    - `insights` object, nullable: 30-day growth insight.
      - `fdiff` union: Absolute follower-difference over the window (period-end minus period-start).
        - number, float
        - string
      - `fdiff_percent` number, float, nullable: Percentage follower-difference over the window.
      - `sns` string, nullable: Social/streaming metric key the diff applies to (e.g. `spotify_m`, `instagram_f`).
      - `value` union: Latest absolute value of the metric at the end of the window.
        - number, float
        - string
    - `weekInsights` object, nullable: 7-day growth insight.
      - `fdiff` union: Absolute follower-difference over the window (period-end minus period-start).
        - number, float
        - string
      - `fdiff_percent` number, float, nullable: Percentage follower-difference over the window.
      - `sns` string, nullable: Social/streaming metric key the diff applies to (e.g. `spotify_m`, `instagram_f`).
      - `value` union: Latest absolute value of the metric at the end of the window.
        - number, float
        - string
    - `twoMonthInsights` object, nullable: 60-day growth insight.
      - `fdiff` union: Absolute follower-difference over the window (period-end minus period-start).
        - number, float
        - string
      - `fdiff_percent` number, float, nullable: Percentage follower-difference over the window.
      - `sns` string, nullable: Social/streaming metric key the diff applies to (e.g. `spotify_m`, `instagram_f`).
      - `value` union: Latest absolute value of the metric at the end of the window.
        - number, float
        - string
    - `sp_followers` integer, nullable: Latest Spotify follower count.
    - `signed` boolean, nullable: Whether the artist is currently signed to a record label.

---

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