Social Audience Stats Time Series

​

Time-series of Instagram / TikTok / YouTube audience stats. Pass domain (instagram, tiktok, youtube), audienceType (followers, likes, notable_followers, ...), and statsType (stat, demographic, country, city, language, brand, interest) plus since / until. Each item's keys depend on the requested statsType — e.g. stat rows carry engagement counters, country rows carry code2 + rank + weights, city rows add city_id + city_name + city_affinity. Data is daily historical and may differ slightly from the web app's near-real-time view.

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

    Social platform. One of instagram, youtube, tiktok. Different platforms support different audienceType and statsType combinations.

    values
    • instagram
    • youtube
    • tiktok
  • audienceType
    Type: string
    required

    Audience subset. One of followers, likes, commenters. Valid combinations with domain are platform-specific.

  • statsType
    Type: string
    required

    Audience metric kind. One of country, city, interest, brand, language, stat, demographic. Valid combinations with domain are platform-specific.

  • since
    Type: string Format: date

    Start of the date window in ISO format (e.g. '2025-11-01'). Defaults to today.

  • until
    Type: string Format: date

    End of the date window in ISO format (e.g. '2025-11-15'). Defaults to today.

  • offset
    Type: integer
    min:  
    0

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

  • limit
    Type: integer
    min:  
    0
    max:  
    100

    Maximum number of entries to return. Defaults to 50, max 100.

Responses
  • application/json
Request Example for get/api/artist/{id}/social-audience-stats
curl 'https://api.chartmetric.com/api/artist/2/social-audience-stats?domain=instagram&audienceType=&statsType=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": [
    {
      "timestp": "2021-09-15",
      "followers": 266129565,
      "avg_likes_per_post": 4611034,
      "avg_comments_per_post": 25014,
      "avg_views_per_post": 7397898,
      "engagement_rate": 1.742
    }
  ]
}

Success