Nexlev Logo

Docs

Search documentation

Search docs by page title or heading

Channel Analytics API

Retrieve detailed analytics data for any YouTube channel — subscriber counts, video counts, view counts, geography/demographics, and short vs. long-form view performance.

Base URL: https://prod.dashboard.nexlev.io — see Authentication for the required header.

Operations Quick Reference

OperationMethod & PathQuota Cost
Get AnalyticsPOST /api/external/analytics/channel-analytics🥞 10
Get Geography Demographics RevenuePOST /api/external/analytics/channel-analytics/geography-revenue🥞 20
Get Short vs Long ViewsGET /api/external/analytics/channel-analytics/:channelId/short-vs-long-views🥞 1

Available Operations

The Channel Analytics resource provides three different operations to retrieve channel analytics data:

Get Analytics

POST /api/external/analytics/channel-analytics

Description: Retrieve comprehensive channel analytics including subscriber count, video count, view count, and detailed channel information.

cURL Example:

curl -X POST https://prod.dashboard.nexlev.io/api/external/analytics/channel-analytics \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA"}'

Request Body:

{
  "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA"
}

🥞 Quota Cost: 10 quota per request — see Rate Limits & Quota.

When to use this operation:

  • Building channel profile dashboards with complete metadata
  • Tracking channel growth metrics over time
  • Comparing multiple channels for competitive analysis
  • Gathering channel information for research databases

Status Code: 200 OK

Response Body:

[
  {
    "about": {
      "description": "SUBSCRIBE FOR A COOKIE!\nNew MrBeast or MrBeast Gaming video every single Saturday at noon eastern time!\nAccomplishments:\n- Raised $20,000,000 To Plant 20,000,000 Trees\n- Removed 30,000,000 pounds of trash from the ocean\n- Helped 2,000 people walk again\n- Helped 1,000 blind people see\n- Helped 1,000 deaf people hear\n- Built wells in Africa\n- Built and gave away 100 houses\n- Adopted every dog in a shelter (twice)\n- Given millions to charity\n- Started my own snack company Feastables\n- Started my own software company Viewstats\n- Started Lunchly, a tasty, better-for-you lunch option\n- Gave away a private island (twice)\n- Gave away 1 million meals\n- I counted to 100k\n- Ran a marathon in the world's largest shoes\n- Survived 50 hours in Antarctica\n- Recreated Squid Game in real life\n- Created the largest competition show with 1000 people (Beast Games)\n- Gave $5,000,000 to one person\n- Passed T-Series to become most subscribed YouTube channel 🥹\nyou get it, I appreciate all of you so much :)\n",
      "subscriberCount": 454000000,
      "viewCount": 102990519473,
      "videoCount": 929,
      "joinedDate": "2012-02-19",
      "country": "United States",
      "links": [
        {
          "title": "TEAM WATER!",
          "url": "teamwater.org"
        },
        {
          "title": "Follow",
          "url": "instagram.com/mrbeast"
        },
        {
          "title": "Twitter",
          "url": "twitter.com/MrBeast"
        },
        {
          "title": "Facebook",
          "url": "facebook.com/mrbeast"
        }
      ],
      "channelUrl": "https://youtube.com/channel/UCX6OQ3DkcsbYNE6H8uQQuVA",
      "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
      "daysSinceStart": 5044,
      "avgVideoLengthSeconds": 1321.6440677966102,
      "avgVideoLength": "22:01",
      "channelName": "MrBeast",
      "thumbnail": [
        {
          "url": "https://yt3.googleusercontent.com/nxYrc_1_2f77DoBadyxMTmv7ZpRZapHR5jbuYe7PlPd5cIRJxtNNEYyOC0ZsxaDyJJzXrnJiuDE=s160-c-k-c0x00ffffff-no-rj",
          "width": 160,
          "height": 160
        }
      ],
      "hasShorts": true,
      "lastVideoUploadDate": "4 days ago"
    },
    "channelId": "UCX6OQ3DkcsbYNE6H8uQQuVA",
    "keywords": [],
    "tags": ["mrbeast6000", "beast", "mrbeast", "Mr.Beast", "mr"],
    "categories": ["Philanthropy", "Vlogs", "Entertainment"]
  }
]

Response Fields:

  • about - Comprehensive channel information including all metrics
    • description - Full channel description with accomplishments
    • subscriberCount - Total subscriber count
    • viewCount - Total cumulative views across all videos
    • videoCount - Total number of published videos
    • joinedDate - Channel creation date (YYYY-MM-DD format)
    • country - Channel country location
    • links - Social media and external links
    • channelUrl - Full YouTube channel URL
    • channelId - YouTube channel identifier
    • daysSinceStart - Days since channel creation
    • avgVideoLengthSeconds - Average video length in seconds
    • avgVideoLength - Average video length formatted (MM:SS)
    • channelName - Display name of the channel
    • thumbnail - Channel avatar with URL, width, and height
    • hasShorts - Whether channel publishes YouTube Shorts
    • lastVideoUploadDate - Relative time since last upload (e.g., "4 days ago")
  • channelId - YouTube channel unique identifier
  • keywords - Channel-level keywords (empty array if none)
  • tags - Channel tags for categorization
  • categories - Content categories (e.g., "Philanthropy", "Vlogs", "Entertainment")

Error Responses

Status Code: 400 Bad Request

Description: The request was invalid or malformed.

{
  "error": {
    "code": 400,
    "message": "Invalid channel ID format",
    "details": "Channel ID must be a valid YouTube channel identifier"
  }
}