Analyze Channel Niche API

AI-powered niche analysis for any YouTube channel — positioning, content strategy, target audience, and competitive landscape.

Base URL: https://prod.dashboard.nexlev.io — see Authentication.

Analyze

POST /api/external/niche-overview/analyze

Description: Perform comprehensive niche analysis on a YouTube channel to understand its positioning, content strategy, target audience, and competitive landscape.

cURL Example:

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

Request Body:

{
  "channelId": "UC9XrHBgOxsNFEBXkLtEqCwA"
}

Status Code: 200 OK

Description: Returns comprehensive niche analysis including similar channels ranked by similarity score and sample videos from channels within the same niche. This data helps you understand the competitive landscape and identify content patterns.

Response Body:

{
  "originalChannelId": "UC9XrHBgOxsNFEBXkLtEqCwA",
  "similarChannels": [
    {
      "channelId": "UCHbx9IUW7eCeJsC4sBCTNBA",
      "channelName": "Tech Innovators",
      "similarityScore": 72
    },
    {
      "channelId": "UCBJycsmduvYEL83R_U4JriQ",
      "channelName": "Digital Creators Pro",
      "similarityScore": 68
    },
    {
      "channelId": "UCMiJRAwDNSNzuYeN2uWa0pA",
      "channelName": "Content Strategy Hub",
      "similarityScore": 62
    },
    {
      "channelId": "UCmlsu3V3SzIm2Jmo0S0qiMg",
      "channelName": "YouTube Mastery",
      "similarityScore": 62
    },
    {
      "channelId": "UC20o1OUWGrixnCEE1gQ9clg",
      "channelName": "Creator Academy",
      "similarityScore": 61
    },
    {
      "channelId": "UCSvD1S5kHsr9tvD3gDXkPkQ",
      "channelName": "Growth Hackers TV",
      "similarityScore": 55
    },
    {
      "channelId": "UCsTcErHg8oDvUnTzoqsYeNw",
      "channelName": "Viral Video Secrets",
      "similarityScore": 54
    },
    {
      "channelId": "UClXdQLTwoi_hOP_36EtdF1g",
      "channelName": "Algorithm Experts",
      "similarityScore": 54
    },
    {
      "channelId": "UC2q1EOP5KEkKBgFRdnAvpwQ",
      "channelName": "Thumbnail Masters",
      "similarityScore": 53
    },
    {
      "channelId": "UCupAYiW_BhnaAVFpA3iB7ng",
      "channelName": "Analytics Guru",
      "similarityScore": 52
    },
    {
      "channelId": "UCkPRaVKwxwqKkQsFD_FursQ",
      "channelName": "Video Marketing Pro",
      "similarityScore": 51
    },
    {
      "channelId": "UCq30pSBD9tX6d5_xT5aNPoA",
      "channelName": "SEO for Creators",
      "similarityScore": 50
    }
  ],
  "videos": [
    {
      "channelId": "UCSvD1S5kHsr9tvD3gDXkPkQ",
      "channelName": "Growth Hackers TV",
      "channelThumbnail": "https://yt3.googleusercontent.com/example-thumbnail-url-1/s160-c-k-c0x00ffffff-no-rj",
      "subscriptionCount": 78400,
      "videos": [
        {
          "type": "video",
          "videoId": "V4yjn0Nn4DE",
          "title": "10 YouTube Algorithm Secrets That Will Boost Your Views",
          "description": "",
          "viewCount": "60,298 views",
          "publishedTimeText": "2 months ago",
          "publishDate": "2024-10-02",
          "publishedAt": "2024-10-02T00:00:00Z",
          "lengthText": "12:28",
          "thumbnail": [
            {
              "url": "https://i.ytimg.com/vi/example-thumbnail-1/hqdefault.jpg",
              "width": 336,
              "height": 188
            }
          ],
          "richThumbnail": [
            {
              "url": "https://i.ytimg.com/an_webp/example-thumbnail-1/mqdefault_6s.webp",
              "width": 320,
              "height": 180
            }
          ],
          "vph": 41.063133261187026,
          "outlierScore": 0.4626266891481021
        },
        {
          "type": "video",
          "videoId": "NuMHqlvZ4HQ",
          "title": "How to Create Viral Thumbnails: Complete Guide",
          "description": "",
          "viewCount": "129,684 views",
          "publishedTimeText": "2 months ago",
          "publishDate": "2024-10-02",
          "publishedAt": "2024-10-02T00:00:00Z",
          "lengthText": "5:29",
          "thumbnail": [
            {
              "url": "https://i.ytimg.com/vi/example-thumbnail-2/hqdefault.jpg",
              "width": 336,
              "height": 188
            }
          ],
          "richThumbnail": [
            {
              "url": "https://i.ytimg.com/an_webp/example-thumbnail-2/mqdefault_6s.webp",
              "width": 320,
              "height": 180
            }
          ],
          "vph": 88.31522395176918,
          "outlierScore": 0.9949795939414654
        },
        {
          "type": "video",
          "videoId": "Xyz1234abcd",
          "title": "YouTube SEO Strategy 2024: Rank #1 on Search",
          "description": "",
          "viewCount": "45,821 views",
          "publishedTimeText": "3 months ago",
          "publishDate": "2024-09-15",
          "publishedAt": "2024-09-15T00:00:00Z",
          "lengthText": "8:42",
          "thumbnail": [
            {
              "url": "https://i.ytimg.com/vi/example-thumbnail-3/hqdefault.jpg",
              "width": 336,
              "height": 188
            }
          ],
          "richThumbnail": [
            {
              "url": "https://i.ytimg.com/an_webp/example-thumbnail-3/mqdefault_6s.webp",
              "width": 320,
              "height": 180
            }
          ],
          "vph": 35.78234567890123,
          "outlierScore": 0.3245678901234567
        }
      ]
    },
    {
      "channelId": "UCHbx9IUW7eCeJsC4sBCTNBA",
      "channelName": "Tech Innovators",
      "channelThumbnail": "https://yt3.googleusercontent.com/example-thumbnail-url-2/s160-c-k-c0x00ffffff-no-rj",
      "subscriptionCount": 142500,
      "videos": [
        {
          "type": "video",
          "videoId": "Abc5678efgh",
          "title": "Content Calendar Secrets Every Creator Needs",
          "description": "",
          "viewCount": "87,543 views",
          "publishedTimeText": "1 month ago",
          "publishDate": "2024-11-01",
          "publishedAt": "2024-11-01T00:00:00Z",
          "lengthText": "10:15",
          "thumbnail": [
            {
              "url": "https://i.ytimg.com/vi/example-thumbnail-4/hqdefault.jpg",
              "width": 336,
              "height": 188
            }
          ],
          "richThumbnail": [
            {
              "url": "https://i.ytimg.com/an_webp/example-thumbnail-4/mqdefault_6s.webp",
              "width": 320,
              "height": 180
            }
          ],
          "vph": 52.34567890123456,
          "outlierScore": 0.567890123456789
        },
        {
          "type": "video",
          "videoId": "Def9012ijkl",
          "title": "Monetization Mistakes to Avoid in 2024",
          "description": "",
          "viewCount": "123,456 views",
          "publishedTimeText": "3 weeks ago",
          "publishDate": "2024-11-10",
          "publishedAt": "2024-11-10T00:00:00Z",
          "lengthText": "14:33",
          "thumbnail": [
            {
              "url": "https://i.ytimg.com/vi/example-thumbnail-5/hqdefault.jpg",
              "width": 336,
              "height": 188
            }
          ],
          "richThumbnail": [
            {
              "url": "https://i.ytimg.com/an_webp/example-thumbnail-5/mqdefault_6s.webp",
              "width": 320,
              "height": 180
            }
          ],
          "vph": 73.45678901234567,
          "outlierScore": 0.7890123456789012
        }
      ]
    }
  ],
  "totalChannels": 12,
  "totalVideos": 703
}

Response Fields:

originalChannelId - The channel ID that was analyzed
similarChannels - Array of channels similar to the target channel
- channelId - Unique identifier for the similar channel
- channelName - Display name of the similar channel
- similarityScore - Similarity score (0-100), higher indicates greater similarity
videos - Array of sample video collections from similar channels
- channelId - Channel ID of the video owner
- channelName - Name of the channel
- channelThumbnail - URL to the channel's profile image
- subscriptionCount - Number of subscribers on the channel
- videos - Array of video objects from this channel
  - type - Content type (typically "video")
  - videoId - Unique video identifier
  - title - Video title
  - description - Video description
  - viewCount - Formatted view count
  - publishedTimeText - Human-readable publish time (e.g., "2 months ago")
  - publishDate - ISO date of publication
  - publishedAt - ISO 8601 timestamp
  - lengthText - Video duration
  - thumbnail - Array of thumbnail objects with URL, width, and height
  - richThumbnail - Array of animated thumbnail objects (if available)
  - vph - Views per hour metric
  - outlierScore - Performance score indicating how much the video outperforms average
totalChannels - Total number of similar channels found
totalVideos - Total number of sample videos included

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"
  }
}

Status Code: 401 Unauthorized

Description: Authentication credentials are missing or invalid.

{
  "error": {
    "code": 401,
    "message": "Unauthorized",
    "details": "Invalid API key or credentials not provided. Create your API key at https://dashboard.nexlev.io/nexlev-api/create-api-key"
  }
}

Status Code: 404 Not Found

Description: The specified channel could not be found.

{
  "error": {
    "code": 404,
    "message": "Channel not found",
    "details": "No channel exists with the provided channel ID"
  }
}

Status Code: 429 Too Many Requests

Description: You have exceeded your API rate limit.

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "details": "You have exceeded your API quota. Please try again later.",
    "retryAfter": 3600
  }
}

Status Code: 503 Service Unavailable

Description: The AI analysis service is temporarily unavailable.

{
  "error": {
    "code": 503,
    "message": "Analysis service unavailable",
    "details": "The niche analysis engine is temporarily unavailable. Please try again in a few minutes.",
    "retryAfter": 300
  }
}