Channel Analytics

GET /v1/youtube/channel/analytics?handle=MrBeast&tz=Europe/Istanbul

{
  "success": true,
  "credits_remaining": 4980,
  "credits_charged": 2,
  "platform": "youtube",
  "owner": {
    "id": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "username": "MrBeast",
    "display_name": "MrBeast"
  },
  "followers": 523000000,
  "sample": {
    "posts": 30,
    "from": "2025-08-30T16:00:11Z",
    "to": "2026-10-17T16:00:18Z",
    "posts_read": 30,
    "pinned_excluded": 0,
    "reposts_excluded": 0
  },
  "likes": {
    "posts": 30,
    "missing": 0,
    "total": 81303427,
    "average": 2710114.23,
    "median": 2543769
  },
  "comments": {
    "posts": 30,
    "missing": 0,
    "total": 4405000,
    "average": 146833.33,
    "median": 96500
  },
  "views": {
    "posts": 30,
    "missing": 0,
    "total": 4780014593,
    "average": 159333819.77,
    "median": 145852029
  },
  "engagement_rate_by_followers": 0.5463,
  "engagement_rate_by_views": 1.7931,
  "posts_per_week": 0.49,
  "posting_times": {
    "timezone": "Europe/Istanbul",
    "metric": "engagement",
    "posts": 30,
    "by_weekday": [
      {
        "weekday": "monday",
        "posts": 0,
        "average_engagement": null
      },
      {
        "weekday": "tuesday",
        "posts": 0,
        "average_engagement": null
      }
    ],
    "by_hour": [
      {
        "hour": 0,
        "posts": 0,
        "average_engagement": null
      },
      {
        "hour": 1,
        "posts": 0,
        "average_engagement": null
      }
    ],
    "best_weekday": "saturday",
    "best_hour": 19,
    "best_slot": {
      "weekday": "saturday",
      "hour_from": 18,
      "hour_to": 21
    },
    "min_posts": 2
  },
  "formula_version": 2,
  "formulas": {
    "average": "total / posts, over the sampled posts that have the value",
    "median": "the middle value of the sampled posts that have the value; the mean of the two middle values when their number is even",
    "engagement_rate_by_followers": "100 * average(likes + comments) / followers, over the sampled posts whose likes and comments are both known; null when followers is 0 or unknown",
    "engagement_rate_by_views": "100 * sum(likes + comments) / sum(views), over the sampled posts whose likes, comments and views are all known; null when that sum of views is 0",
    "posts_per_week": "(sample.posts - 1) / ((sample.to - sample.from) in days / 7); null with fewer than 2 posts or when they share one timestamp",
    "posting_times": "engagement = likes + comments of each sampled post whose likes, comments and exact time are known (a time worked back from \"3 weeks ago\" is not); each such post counts in its weekday, its hour and its weekday's 3-hour slot (00-03, 03-06, ... 21-24) in the asked time zone; average_engagement = total engagement / posts of the bucket, null without posts; best_weekday, best_hour, best_slot = the highe…"
  }
}