Skip to content
Docs

Channel Content API

REST API reference for fetching YouTube channel details, videos, shorts, playlists, and outlier analysis. Endpoint paths, request/response schemas, and pagination.

Fetch YouTube channel details, videos, shorts, playlists, and outlier analysis.

Base URL: https://prod.dashboard.nexlev.io — see Authentication. All 5 operations cost 🥞 1 quota per request — see Rate Limits & Quota.

Operations Quick Reference

OperationMethod & Path
Get AboutGET /api/external/channels/about
Get VideosGET /api/external/channels/videos
Get ShortsGET /api/external/channels/shorts
Get PlaylistsGET /api/external/channels/playlists
Get OutliersGET /api/external/channels/outliers

Available Operations

The Channel Content resource provides five different operations to retrieve various types of channel data:

Get About

GET /api/external/channels/about

Description: Retrieve comprehensive channel metadata including title, description, subscriber count, social links, and channel statistics.

Query Parameters: forUsername (optional) or id (optional) - YouTube username or channel ID

Note: Provide either forUsername or id, not both.

Example URLs:

https://prod.dashboard.nexlev.io/api/external/channels/about?forUsername=@DavidFraserYT
https://prod.dashboard.nexlev.io/api/external/channels/about?id=UCBJycsmduvYEL83R_U4JriQ

cURL Example:

curl "https://prod.dashboard.nexlev.io/api/external/channels/about?id=UCBJycsmduvYEL83R_U4JriQ" \
  -H "Authorization: Bearer YOUR_API_KEY"

Get detailed information about a YouTube channel including description, avatar, banner, channel handle, and subscriber information.

When to use this operation:

  • Gathering channel profile information for research
  • Building channel databases with metadata
  • Extracting social media links and contact information
  • Verifying channel authenticity and statistics

Parameters:

ParameterTypeRequiredDescription
idstringOne of id/forUsernameThe unique YouTube channel identifier
forUsernamestringOne of id/forUsernameYouTube handle (e.g. @DavidFraserYT)

Status Code: 200 OK

Response Body:

{
  "channelId": "UCBJycsmduvYEL83R_U4JriQ",
  "title": "Marques Brownlee",
  "description": "MKBHD: Quality Tech Videos | YouTuber | Geek | Consumer Electronics | Tech Head | Internet Personality!\n\nbusiness@MKBHD.com\n\nNYC",
  "avatar": [
    {
      "url": "https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s160-c-k-c0x00ffffff-no-rj",
      "width": 160,
      "height": 160
    },
    {
      "url": "https://yt3.googleusercontent.com/qu4TmIaYUlS41-dJ9gZ7DUR3nilvmB5_11i6OKSdvNnBNiyOusZP1bMN6ICnuxtjFBb6ioKgRQ=s72-c-k-c0x00ffffff-no-rj",
      "width": 72,
      "height": 72
    }
  ],
  "metaD": "UCBJycsmduvYEL83R_U4JriQ",
  "banner": [],
  "channelHandle": "@mkbhd",
  "subscriberCountText": "20.6M subscribers",
  "subscriberCount": 20600000,
  "videosCountText": "1,785 videos",
  "videosCount": "1785",
  "keywords": ["MKBHD", "MarquesBrownlee", "Marques", "Brownlee"],
  "isFamilySafe": true,
  "isUnlisted": false,
  "availableCountries": ["SL", "TT", "EH", "NU", "SA", "AG", "GA", "..."],
  "tabs": ["Home", "Videos", "Shorts", "Live", "Playlists", "Posts", "Store"],
  "country": "United States",
  "viewCountText": "5,142,094,005 views",
  "viewCount": "5142094005",
  "joinedDateText": "Joined Mar 21, 2008",
  "joinedDate": "2008-03-21",
  "links": [
    {
      "title": "Twitter",
      "link": "twitter.com/MKBHD",
      "favicon": [
        {
          "url": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcQYbMNQ3a7LqKzqhkvBsowNn_ZiyMTETw8naXxDTLsn12SAxcLwxr9aVzQcAb7yfXeaFg-H0NjXyKBK7kTt_tVF4RfZ3OtAiFZvpqW0lZB4iQ",
          "width": 256,
          "height": 256
        },
        {
          "url": "https://encrypted-tbn1.gstatic.com/favicon-tbn?q=tbn:ANd9GcRfrgN-vDv2HHFDMwk8GargknaDuXUO2BuEQtUv7Ue0CI2uPorX5JDp48wjQ6JtyrF590nARXhnUVs-5R0o0dY3zKMtmGxJdNwtDiX23Gvv",
          "width": 32,
          "height": 32
        }
      ]
    },
    {
      "title": "Instagram",
      "link": "instagram.com/MKBHD",
      "favicon": [
        {
          "url": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcSMItu-kpj9mUqJlYFLBMsNp279lOFn_WdIAoqsMZYtJYhjg8xQh9qCgB3BvVFbtYpLemKWr-ZbwnTCA2jDa_i60wjmuwUIX-vxhbaBmAQONd2D",
          "width": 256,
          "height": 256
        },
        {
          "url": "https://encrypted-tbn0.gstatic.com/favicon-tbn?q=tbn:ANd9GcRHmEJzjUkw7J1XBesfOY377AVoQe5m75w7LUT44H77vERWBHa8BjlyEZEbPQRUubv0p5FMgFYb-91m2f7M-QMk18WOl3Tf_llyYuSI5P-DpHE",
          "width": 32,
          "height": 32
        }
      ]
    }
  ],
  "hasEmail": true,
  "msg": ""
}

Response Fields:

  • channelId - Unique channel identifier
  • title - Channel name
  • description - Channel description/bio
  • avatar - Array of avatar images in different sizes (160px, 72px)
  • metaD - Channel metadata identifier
  • banner - Array of banner images (may be empty)
  • channelHandle - Channel handle (e.g., @mkbhd)
  • subscriberCountText - Formatted subscriber count (e.g., "20.6M subscribers")
  • subscriberCount - Raw subscriber count number
  • videosCountText - Formatted video count
  • videosCount - Raw video count
  • keywords - Array of channel keywords/tags
  • isFamilySafe - Boolean indicating if channel is family-safe
  • isUnlisted - Boolean indicating if channel is unlisted
  • availableCountries - Array of country codes where content is available
  • tabs - Array of available tabs on the channel
  • country - Channel's country of origin
  • viewCountText - Formatted total view count
  • viewCount - Raw total view count
  • joinedDateText - Human-readable join date
  • joinedDate - ISO date of channel creation
  • links - Array of external links with favicons
  • hasEmail - Boolean indicating if channel has email available
  • msg - Status message (empty on success)

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

Last updated