Nexlev Logo

Docs

Search documentation

Search docs by page title or heading

Channel Analysis

The Channel Analysis API provides comprehensive deep-dive analytics for YouTube channels through a two-step asynchronous process. This powerful feature analyzes channel performance, content strategy, audience demographics, and revenue metrics.

Overview

Channel Analysis is designed for in-depth channel investigation that requires more processing time than standard analytics. The API uses a job-based system where you first create an analysis job and then retrieve the results when processing is complete.

Quick Start

Get started with the two-step process:

  1. Install NexLev: Add the NexLev node to your n8n instance (Installation Guide)
  2. Get API Key: Create your API key at API Key
  3. Create Analysis Job:
    • Add NexLev node → Select "Channel Analysis" → Choose "Create Job"
    • Enter a Channel ID (e.g., UCoLvjCESbwNnh9l873T2OEQ)
    • Execute to create the analysis job
  4. Wait for Processing: Add a Wait node (30-60 seconds recommended)
  5. Get Results:
    • Add another NexLev node → Select "Channel Analysis" → Choose "Get Result"
    • Use the job_id from step 3
    • Execute to retrieve comprehensive analysis

Example Result: You'll receive deep strategic insights including content buckets, title formats, audience sentiment, script blueprints, and AI-powered recommendations.

Endpoint Details

  • Resource: Channel Analysis
  • Operations: Create Job | Get Result
  • Authentication: Required (API Key)
  • Processing Time: Varies (typically 30 seconds to 2 minutes)
  • Quota Cost: 🥞 20 quota (Create Job) · 🥞 1 quota (Get Result)

API Reference

Full endpoint details, cURL examples, and response schemas live in the Channel Analysis API reference.

OperationMethod & PathQuota Cost
Create JobGET /api/external/channels/analysis/job/create🥞 20
Get ResultGET /api/external/channels/analysis/job/status🥞 1

Authentication Required — see Authentication for the required header format and how to get an API key.

How It Works

The Channel Analysis operation uses a two-step workflow — Create Job, then Get Result. See How It Works in the API reference for the full explanation of the async pattern.

Configuration

1

Step 1: Create Channel Analysis Job

First, you need to create an analysis job that will process the channel data in the background.

Parameters

ParameterTypeRequiredDescription
Channel IDstringYesThe unique YouTube channel identifier (e.g., UCoLvjCESbwNnh9l873T2OEQ)

Setup Steps

  1. Add the NexLev node to your workflow (see Quickstart Guide for installation instructions)
  2. Under Resource, select Channel Analysis
  3. Under Operation, select Create Job
  4. Under Credential to connect with, select your NexLev account
  5. In the Channel ID field, enter the YouTube channel ID you want to analyze
Create channel analysis job

Execution

Click Execute step to create the analysis job. You'll receive a response with a job_id that you'll use in the next step.

Response

2

Step 2: Get Channel Analysis Result

After creating the job, use the job_id to retrieve the analysis results. It's recommended to add a wait/delay node between steps to allow processing time.

Parameters

ParameterTypeRequiredDescription
Job IDstringYesThe job ID returned from the Create Job request

Setup Steps

  1. Add a Wait node after the Create Job step (recommended: 30-60 seconds)
  2. Add another NexLev node to your workflow
  3. Under Resource, select Channel Analysis
  4. Under Operation, select Get Result
  5. Under Credential to connect with, select your NexLev account
  6. In the Job ID field, use the job_id from the previous step (use expressions: {{ $json.job_id }})
Get channel analysis result

Execution

Click Execute step to retrieve the analysis results.

Response

Full response schema and key metrics explained: Get Channel Analysis Result — API Reference →

Error Responses

Full error code reference: Channel Analysis — API Reference →

Use Cases

Leverage deep channel analysis data for:

  • Content Strategy Replication: Analyze successful channels to understand their content buckets, title formats, and video structures
  • Competitive Intelligence: Deep-dive into competitor performance patterns, audience sentiment, and strategic positioning
  • Script Development: Use the script blueprint data to structure your videos based on proven formulas
  • Title Optimization: Learn from top-performing title formats and patterns to craft better video titles
  • Audience Understanding: Gain insights into what viewers like and dislike through sentiment analysis
  • Performance Benchmarking: Compare your channel metrics against successful channels in your niche
  • Content Gap Analysis: Identify underserved topics and content opportunities through AI-generated suggestions
  • Video Format Optimization: Understand optimal video lengths, pacing, and narrative structures
  • Automated Channel Scoring: Build workflows that score channels based on competition and opportunity metrics
  • Partnership Evaluation: Assess potential collaborators using comprehensive audience and performance data
  • Growth Strategy Planning: Use AI strategic recommendations to identify actionable growth opportunities
  • Niche Viability Assessment: Evaluate niche competition scores before entering a market

Data Points Included

The Channel Analysis API provides comprehensive insights across multiple strategic dimensions:

Channel Data

  • Channel Information: Title, subscriber count, video count, total views, country, channel type, avatar URL
  • Performance Metrics: Average video length, monthly views, monthly uploads, views per video, upload history

Strategic Insights

  • Content Strategy Analysis

    • Content buckets with categorized videos by theme
    • Confidence scores for each content category
    • Video performance within each bucket
    • Total views and median views per category
  • Title Format Strategy

    • Winning title formats and patterns
    • Performance metrics for each format type
    • Format match scores and recommendations
    • Top performing format identification
  • Audience Insights

    • Viewer feedback analysis (likes and dislikes)
    • Sentiment summary with confidence scores
    • Comment analysis across multiple videos
    • Engagement level assessment
  • Performance Analysis

    • Video length and title length correlations
    • Top vs bottom performing video comparisons
    • Hook types and narrative arc analysis
    • Words-per-minute (WPM) distribution data
  • Script Blueprint

    • Stage-by-stage content structure recommendations
    • Winning formulas for each stage (Hook, Stakes, Rehooks, Climax, Resolution)
    • Successful examples from top videos
    • Usage instructions for content creation
  • AI Strategic Analysis

    • Performance pattern identification
    • Content formula discovery
    • Audience behavior insights
    • Strategic growth opportunities
  • Content Recommendations

    • AI-generated topic suggestions
    • Niche competition scoring
    • Future opportunity assessment

Rate Limits

Per-endpoint hourly limits: Channel Analysis — API Reference →

Support

If you encounter issues or have questions about the Channel Analysis API, please contact our support team at contact@nexlev.io or refer to our troubleshooting guide.