YouTube Audience Stats

​

YouTube audience analysis for an artist (latest report or historical via date). Geo breakdown (top subscribing + commenting countries), gender/age demographics for subscribers and commenters, plus engagement counters (subscribers, avg_likes_per_post, avg_commments_per_post, engagement_rate). Pass geoOnly=true to drop demographic arrays and notable subscribers. Returns a stable shape even when the artist has no linked YouTube channel (arrays empty, counters null/undefined).

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}/youtube-audience-stats
curl https://api.chartmetric.com/api/artist/2/youtube-audience-stats \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "obj": {
    "top_countries": [
      {
        "name": "United States",
        "code": "us",
        "percent": "20.22",
        "subscribers": 8675495
      }
    ],
    "commenters_top_countries": [
      {
        "name": "United States",
        "code": "us",
        "percent": "12.53",
        "comments": 2010886
      }
    ],
    "audience_genders": [
      {
        "code": "female",
        "weight": "27.61"
      },
      {
        "code": "male",
        "weight": "72.39"
      }
    ],
    "subscribers": 42900000,
    "avg_likes_per_post": 112574,
    "avg_commments_per_post": 5679,
    "engagement_rate": 0.2624,
    "timestp": "2022-03-28"
  }
}

Success