Get Cross-Platform Artist IDs

​

Resolve cross-platform artist IDs from any single source. type accepts chartmetric, spotify, itunes, deezer, amazon, youtube (or youtube-channel), and instagram. When aggregate=true, domain arrays are pre-aggregated into a single row; otherwise one row per linked id is returned.

Path Parameters
  • type
    Type: string enum
    required

    Source identifier type. One of chartmetric, spotify, itunes, deezer, amazon, youtube. youtube expects the channel ID, not the artist ID.

    values
    • chartmetric
    • spotify
    • itunes
    • deezer
    • amazon
    • youtube
  • id
    required

    Artist identifier whose format depends on type — numeric for chartmetric/deezer/itunes, alphanumeric/dashed string for amazon/spotify/youtube.

    • Type: integer
      min:  
      2
      max:  
      2147483647

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

      • enum
        const:  
        1
        values
        • 1
Query Parameters
  • offset
    Type: integer
    min:  
    0

    Number of entries to skip. Applied only when aggregate=false.

  • limit
    Type: integer
    min:  
    1
    max:  
    10000

    Maximum number of entries to return when aggregate=false. Defaults to 10000, max 10000. Has no effect when aggregate=true.

  • aggregate
    Type: boolean

    If true, returns a single row with platform IDs aggregated into arrays. Deprecated — preserved for backwards compatibility.

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

{
  "obj": [
    {
      "chartmetric_id": 4904,
      "artist_name": "Hailee Steinfeld",
      "spotify_artist_ids": [
        "5p7f24Rk5HkUZsaS3BLG5F"
      ],
      "itunes_artist_ids": [
        417571723
      ],
      "deezer_artist_ids": [
        "5961630"
      ],
      "amazon_artist_ids": [
        "B00L4I14C0",
        "B00L48A8F4"
      ],
      "youtube_channel_ids": [
        "UCWfytcGFwPSMwvP5HYuXGqw"
      ],
      "instagram_id": 2274763833
    }
  ]
}

Success