💎 Premium — Get Influencer Breakdown for an Artist

​

Distribution of the TikTok creators who used the artist's sounds, one axis per call. dimension selects the axis: country, category (broad content categories), subcategory (the granular creator tags beneath them), age-gender, or language. Aggregates only — the endpoint reports how many creators fall in each bucket, not who they are. A creator holds exactly one country, age/gender bucket and language, so those shares sum to 1 and total is the creator count; a creator can hold several categories, so category and subcategory return counts with share and total null and multi_label true. Distinct from tiktok-audience-stats, which describes the artist's own TikTok followers rather than the creators using their sounds.

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

    Which breakdown to return. category is the broad creator-content layer, subcategory the granular one; a creator can hold several of either, so those two report counts without a share.

    values
    • country
    • category
    • subcategory
    • age-gender
    • language
  • periodDays
    Type: number Format: floatenum

    Rolling window, in days, over the date creators last posted with the artist's sounds. 0 covers all time.

    values
    • 0
    • 7
    • 30
    • 90
Responses
  • application/json
Request Example for get/api/artist/{id}/tiktok-influencer-stats
curl https://api.chartmetric.com/api/artist/2/tiktok-influencer-stats \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "dimension": "age-gender",
    "period_days": 30,
    "total": 91,
    "multi_label": false,
    "available_period_days": [
      0,
      7,
      30,
      90
    ],
    "data": [
      {
        "value": "25-34|female",
        "age_group": "25-34",
        "gender": "female",
        "count": 31,
        "share": 0.340659,
        "delta": 6
      },
      {
        "value": "18-24|female",
        "age_group": "18-24",
        "gender": "female",
        "count": 30,
        "share": 0.32967,
        "delta": -6
      }
    ]
  }
}

Success