A&R Artists by Social Index

​

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
    Type: integer
    min:  
    0
    max:  
    10000

    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
    Type: integer
    min:  
    1
    max:  
    0

    Maximum number of artists to return. Defaults to 10, max 100.

  • sortBy
    Type: string enum
    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.

    values
    • spotify_popularity
    • spotify_followers
    • spotify_monthly_listeners
    • facebook_likes
    • twitter_followers
  • tagIds
    Type: integer

    Optional parent genre ID to restrict the result set.

  • subTagIds
    Type: integer

    Optional child genre ID. Deprecated and has no effect on the model — kept for backwards compatibility.

  • code2
    Type: string
    min length:  
    2
    max length:  
    2

    ISO 3166-1 alpha-2 country code (2 letters, e.g. 'US', 'BR', 'GB').

  • sortOrderDesc
    Type: boolean

    If true (default), sort descending by sortBy.

  • minThirtyDayGrowth
    Type: integer

    Minimum 30-day growth threshold for sortBy.

  • maxThirtyDayGrowth
    Type: integer

    Maximum 30-day growth threshold for sortBy.

  • minSpotifyFollowers
    Type: integer

    Minimum Spotify followers filter. Defaults to -1 (no minimum).

  • maxSpotifyFollowers
    Type: integer

    Maximum Spotify followers filter. Defaults to -1 (no maximum).

  • recentReleaseWithin
    Type: integer

    Restrict to artists whose first release is within this many days of today. Defaults to 2555 (~7 years).

  • latestReleaseWithin
    Type: integer

    Restrict to artists whose latest release is within this many days of today. Defaults to 60.

  • unsigned
    Type: boolean

    If true (default), restrict the result set to unsigned artists.

Responses
  • application/json
Request Example for get/api/artist/anr/by/social-index
curl 'https://api.chartmetric.com/api/artist/anr/by/social-index?sortBy=spotify_popularity' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "name": "jnhygs",
      "code2": null,
      "image_url": "https://i.scdn.co/image/ab67616100005174e370de7eb3169eeeb57bf5d1",
      "tags": [
        "Hip-Hop/Rap",
        "Pop",
        "Electronic"
      ],
      "spotify_artist_ids": [
        "0H942IkjXv9bjx5OxoG7kh"
      ],
      "id": "9995920",
      "releases": [
        {
          "cm_album": 26281529,
          "album_name": "XTAYALIVE",
          "release_date": "2023-02-19T00:00:00.000Z",
          "label": "4990469 Records DK",
          "image_url": "https://i.scdn.co/image/ab67616d0000b2734b1357973723dcf2e1a9cbe0",
          "upc": "197631029842"
        }
      ],
      "weekInsights": {
        "fdiff": 388076,
        "fdiff_percent": 21.7568,
        "sns": "spotify_m",
        "value": 2171776
      },
      "insights": {
        "fdiff": 1896287,
        "fdiff_percent": 688.3349,
        "sns": "spotify_m",
        "value": 2171776
      },
      "twoMonthInsights": {
        "fdiff": null,
        "fdiff_percent": null,
        "sns": "spotify_m",
        "value": 2171776
      },
      "sp_followers": 13371,
      "signed": false
    }
  ]
}

Success