Similar Artists by Configurations

​

Similar artists ranked by weighted embedding configurations (audience, mood, genre, musicality). Query must include at least one configuration. The target artist is pinned first in data. Pass segmentSize to switch to a segmented shape (by_stage / by_health) instead of a flat list.

Path Parameters
  • id
    Type: integer
    min:  
    2
    max:  
    2147483647
    required

    Chartmetric artist ID. Note: id=1 ('Various Artists') is rejected.

    • enum
      const:  
      1
      values
      • 1
Query Parameters
  • audience
    Type: string enum

    Weight of audience-similarity dimension. One of low, medium, high.

    values
    • low
    • medium
    • high
  • mood
    Type: string enum

    Weight of mood-similarity dimension. One of low, medium, high.

    values
    • low
    • medium
    • high
  • genre
    Type: string enum

    Weight of genre-similarity dimension. One of low, medium, high.

    values
    • low
    • medium
    • high
  • musicality
    Type: string enum

    Weight of musicality-similarity dimension. One of low, medium, high.

    values
    • low
    • medium
    • high
  • limit
    Type: integer
    min:  
    1

    Maximum number of similar artists to return. Defaults to 20.

  • offset
    Type: integer
    min:  
    0

    Number of items to skip from the start of the result set; pair with limit to paginate.

Responses
  • application/json
Request Example for get/api/artist/{id}/similar-artists/by-configurations
curl https://api.chartmetric.com/api/artist/2/similar-artists/by-configurations \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "data": [
      {
        "id": 213758,
        "name": "Ashe",
        "image_url": "https://i.scdn.co/image/ab6761610000e5eb91054f6fce16973e80f0ed2a",
        "code2": "US",
        "verified": false,
        "gender": 0,
        "band": false,
        "genres": [
          {
            "id": 501160,
            "name": "pop"
          }
        ],
        "subgenres": [
          {
            "id": 419163,
            "name": "indie pop"
          }
        ],
        "primary_genre_smart": {
          "id": 501160,
          "name": "pop"
        },
        "rank": 2657,
        "score": 88.61378455109873,
        "similarity": 0.8710287,
        "career_stage": "mainstream",
        "recent_momentum": "steady",
        "network_strength": "prominent",
        "label": {
          "id": 1038765,
          "name": "Mom + Pop Music"
        },
        "rank_stats_monthly": [],
        "rank_diff_monthly": 0,
        "date_of_birth": "1993-05-07"
      }
    ],
    "total": 10000
  }
}

Success