Nexlev Logo

Docs

Search documentation

Search docs by page title or heading

Personal Channel Analytics

Analyze your own YouTube channel with real data from the YouTube Analytics API — actual views, revenue, audience demographics, traffic sources, and retention curves from the channels you've connected via OAuth.

Prerequisites

  • Connected AI assistant — Claude or ChatGPT with NexLev MCP connected
  • YouTube channel connected via OAuth — Link your channel at dashboard.nexlev.io/analytics
  • Lite, Pro, or Premium plan — Free plans do not have access. Upgrade your plan to get started.

OAuth login required. These tools access your private YouTube Analytics data. API-key connections are blocked — you must connect via OAuth. Link your YouTube channel at dashboard.nexlev.io/analytics.

How to Start

Make sure your YouTube channel is connected at dashboard.nexlev.io/analytics, then mention your channel name in the prompt — Claude or ChatGPT will handle the rest:

Analyse my YouTube channel "your_channel_name"
Show me the last 28 days of stats for my channel "your_channel_name"
Give me a full health check of my YouTube channel "your_channel_name"

Mention your channel name in the prompt. Your AI assistant will match it to your connected channels and run the right tools automatically. If you have multiple channels connected, it will confirm which one you mean before running the analysis.

Tools

list_my_youtube_channels

List all YouTube channels connected to your NexLev account. Call this first — it returns the channel_id values needed by every other tool on this page.

Example prompts:

List my connected YouTube channels
Which YouTube channels do I have linked to NexLev?
Show my channels, then run a full analytics report on the first one

Parameters: None. Returns all channels linked to your authenticated account.

What it returns:

FieldDescription
channelIdThe UC… ID to pass to all other tools
titleChannel display name
thumbnailChannel avatar URL
subscriberCountCurrent subscriber count
totalViewCountLifetime total views
videoCountNumber of public videos

Full Channel Health Check

Paste this into your AI assistant to run a complete analysis:

I want a full health check of my YouTube channel.

1. List my connected channels, then pick the first one.
2. Get the channel overview.
3. Get channel analytics for the last 28 days.
4. Get the revenue report (if monetized).
5. Get my top 10 videos.
6. Get audience demographics.
7. Get traffic sources.
8. Get device and OS breakdown.
9. Get geographic audience data.
10. Get playback locations.
11. Get content sharing breakdown.
12. Get subscriber vs non-subscriber engagement.

Then pick my #1 video and run:
- Detailed video analytics for the last 28 days
- Audience retention curve

Finally, give me a channel health report with overall performance, strongest content, audience insights, retention analysis, and 5 actionable recommendations.

Troubleshooting

ACCESS DENIED on every tool

  • Personal Channel Analytics requires an Lite, Pro, or Premium plan. Upgrade your plan to unlock access.
  • API key connections are blocked — these tools are OAuth-only. Connect via the AI assistant's connector settings (see Quickstart).

AUTH_REQUIRED error

  • Your OAuth session has expired. Re-authenticate by reconnecting in your AI assistant's connector settings or re-authorising at dashboard.nexlev.io/analytics.

Channel ... is not connected to your account

  • The channel_id you passed is not linked to your NexLev account. Call list_my_youtube_channels to see your connected channels and use one of those IDs.

No channels returned by list_my_youtube_channels

Revenue report returns "not monetized" message

  • Your channel is not in the YouTube Partner Program. This is expected behaviour — the tool returns a friendly message rather than an error.

Video analytics returns data without revenue

  • If your channel is not monetized, revenue metrics are automatically excluded. This is expected.

Empty data arrays for a valid channel

  • The channel may have no activity in the requested date range. Try widening the date range or use the default (last 28 days).

Rate Limits

Personal Channel Analytics tools is available on Lite, Pro, and Premium plans only — Free plan users do not have access.

Channel Tools

Tool & DescriptionFreeLitePro
List my YouTube channelslist_my_youtube_channels0100200
Channel overviewget_my_channel_overview02050
Channel analyticsget_my_channel_analytics02050
Revenue reportget_my_revenue_report01540
Top videosget_my_top_videos01540

Per user · resets every 24 hours

Upgrade to Pro →

Audience Tools

Tool & DescriptionFreeLitePro
Audience demographicsget_my_audience_demographics01540
Traffic sourcesget_my_traffic_sources01540
Device & OS reportget_my_device_report01540
Geography reportget_my_geography_report01540
Playback locationsget_my_playback_locations01540
Content sharingget_my_content_sharing01540
Subscriber statusget_my_subscriber_status01540

Per user · resets every 24 hours

Upgrade to Pro →

Video Tools

Tool & DescriptionFreeLitePro
Video analyticsget_my_video_analytics02050
Audience retentionget_my_audience_retention01540

Per user · resets every 24 hours

Upgrade to Pro →

What's Next?