Channel Content API
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
| Operation | Method & Path |
|---|---|
| Get About | GET /api/external/channels/about |
| Get Videos | GET /api/external/channels/videos |
| Get Shorts | GET /api/external/channels/shorts |
| Get Playlists | GET /api/external/channels/playlists |
| Get Outliers | GET /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/aboutDescription: Retrieve comprehensive channel metadata including title, description, subscriber count, social links, and channel statistics.
🥞 Quota Cost: 1 quota per request
Each call to this endpoint deducts 1 quota from your account balance. Monitor your usage at Manage API Key to avoid interruptions.
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:
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | One of id/forUsername | The unique YouTube channel identifier |
forUsername | string | One of id/forUsername | YouTube 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 identifiertitle- Channel namedescription- Channel description/bioavatar- Array of avatar images in different sizes (160px, 72px)metaD- Channel metadata identifierbanner- 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 numbervideosCountText- Formatted video countvideosCount- Raw video countkeywords- Array of channel keywords/tagsisFamilySafe- Boolean indicating if channel is family-safeisUnlisted- Boolean indicating if channel is unlistedavailableCountries- Array of country codes where content is availabletabs- Array of available tabs on the channelcountry- Channel's country of originviewCountText- Formatted total view countviewCount- Raw total view countjoinedDateText- Human-readable join datejoinedDate- ISO date of channel creationlinks- Array of external links with faviconshasEmail- Boolean indicating if channel has email availablemsg- 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"
}
}