Artist Top Tracks by Source

​

Top tracks for an artist on a given source. source is one of cm (Chartmetric's overall ranking), youtubeforartist (YouTube for Artists), or tiktok. Row shape varies per source — all branches emit per-track identifiers (cm_track, isrc, sound id) and engagement counters; tiktok additionally returns a trend time-series + engagementRate. Counter fields may surface as string (uncast PG / Snowflake aggregates).

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
  • source
    Type: string enum
    required

    Short-form / social platform. One of cm, youtubeforartist, tiktok. Row shape varies by source.

    values
    • cm
    • youtubeforartist
    • tiktok
Query Parameters
  • limit
    Type: integer
    max:  
    100

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

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

{
  "obj": [
    {
      "tiktok": "7091431347681856000",
      "tiktok_track_id": "7091431347681856000",
      "tiktok_url": "https://www.tiktok.com/music/original-sound-7091431347681856000",
      "isrc": "USUM72112345",
      "cm_track": 66234422,
      "name": "original sound",
      "image_url": "https://p16-sign.tiktokcdn-us.com/...",
      "audio_url": "https://v16-webapp.tiktok.com/...",
      "tags": "pop,dance pop",
      "views": 12400000,
      "likes": 850000,
      "comments": 4200,
      "posts": 18450,
      "monthly_diff_percent": 0.1234,
      "created_at": "2022-04-21T12:00:00.000Z",
      "score": 82,
      "trend": [
        {
          "timestp": "2022-04-01",
          "value": 12000
        }
      ],
      "engagementRate": 0.0689
    }
  ]
}

Success