TikTok Audience Stats

​

TikTok audience analysis for an artist (latest report or historical via date). Top follower countries, gender/age + gender rollups, and notable followers plus engagement counters (followers, avg_likes_per_post, avg_commments_per_post, engagement_rate). Rate fields come from uncast PG numerics so may surface as strings.

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
  • date
    Type: string Format: date

    Historical date (YYYY-MM-DD). When omitted, returns the most recent available report. Use the dates endpoint to discover available dates.

  • geoOnly
    Type: boolean

    If true, drop demographic / brand-affinity / interest / notable-followers blocks and return only geo + engagement counters.

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

{
  "obj": {
    "top_countries": [
      {
        "name": "United States",
        "code": "us",
        "percent": "20.10",
        "followers": 1500000
      }
    ],
    "audience_genders": [
      {
        "code": "male",
        "weight": "60.00"
      },
      {
        "code": "female",
        "weight": "40.00"
      }
    ],
    "followers": 7500000,
    "avg_likes_per_post": "125000",
    "avg_commments_per_post": "3400",
    "engagement_rate": "0.0217",
    "timestp": "2022-04-03"
  }
}

Success