Video Content API

Retrieve YouTube video details, comments, transcripts, subtitles, and RPM data.

Base URL: https://prod.dashboard.nexlev.io — see Authentication. Most operations cost 🥞 1 quota; bulk transcript/subtitle operations cost 🥞 5 — see Rate Limits & Quota.

Operations Quick Reference

Operation	Method & Path	Quota Cost
Get Video Details	`GET /api/external/videos/details`	🥞 1
Get Shorts Details	`GET /api/external/shorts/details`	🥞 1
Get Comments	`GET /api/external/videos/comments`	🥞 1
Get Transcript	`GET /api/external/videos/transcript`	🥞 1
Get Bulk Transcript	`POST /api/external/videos/bulk-transcript`	🥞 5
Get Subtitle	`GET /api/external/videos/subtitle`	🥞 1
Get Bulk Subtitle	`POST /api/external/videos/bulk-subtitle`	🥞 5
Get RPM	`GET /api/external/videos/rpm`	🥞 1

Available Operations

The Video Content resource provides eight different operations to retrieve various types of video data:

Get Video Details

GET /api/external/videos/details

Description: Retrieve comprehensive metadata for a YouTube video including title, description, view count, likes, channel information, and engagement metrics.

🥞 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: videoId (required) - YouTube video ID

Example:

https://prod.dashboard.nexlev.io/api/external/videos/details?videoId=xIL0ssyMh1k

cURL Example:

curl "https://prod.dashboard.nexlev.io/api/external/videos/details?videoId=xIL0ssyMh1k" \
  -H "Authorization: Bearer YOUR_API_KEY"

Status Code: 200 OK

Response Body:

[
  {
    "id": "dQw4w9WgXcQ",
    "title": "Complete Guide to YouTube Success in 2024",
    "lengthSeconds": "942",
    "keywords": ["youtube", "tutorial", "growth", "2024"],
    "channelTitle": "Tech Creators Hub",
    "channelId": "UCxYz123ABC456DEF789GHI",
    "description": "In this comprehensive guide, we cover everything you need to know about growing your YouTube channel from scratch to success.",
    "thumbnail": [
      {
        "url": "https://i.ytimg.com/vi/dQw4w9WgXcQ/hqdefault.jpg?sqp=-oaymwEbCKgBEF5IVfKriqkDDggBFQAAiEIYAXABwAEG&rs=example",
        "width": 168,
        "height": 94
      }
    ],
    "allowRatings": true,
    "viewCount": "125430",
    "likeCount": "4521",
    "isPrivate": false,
    "isUnpluggedCorpus": false,
    "isLiveContent": false,
    "isCrawlable": true,
    "isFamilySafe": true,
    "availableCountries": ["US", "GB", "CA", "AU", "DE", "FR", "JP", "IN"],
    "isUnlisted": false,
    "category": "Education",
    "publishDate": "2024-08-15T10:30:00-07:00",
    "publishedAt": "2024-08-15T10:30:00-07:00",
    "uploadDate": "2024-08-15T10:30:00-07:00",
    "isShortsEligible": false,
    "hasCaption": true,
    "playableInEmbed": true
  }
]

Response Fields:

id - The YouTube video ID
title - Video title
lengthSeconds - Video duration in seconds
keywords - Array of video keywords/tags
channelTitle - Name of the channel that uploaded the video
channelId - Unique identifier for the video's channel
description - Video description
thumbnail - Array of video thumbnail objects
allowRatings - Whether ratings are allowed on the video
viewCount - Total view count
likeCount - Total like count
isPrivate - Whether the video is private
isUnpluggedCorpus - Whether the video is part of YouTube Unplugged
isLiveContent - Whether the video is/was a live stream
isCrawlable - Whether the video can be crawled
isFamilySafe - Whether the video is family-safe
availableCountries - List of country codes where the video is available
isUnlisted - Whether the video is unlisted
category - Video category (e.g., "Education", "Entertainment")
publishDate - Original publish date with timezone
publishedAt - ISO 8601 timestamp of publish date
uploadDate - Upload date with timezone
isShortsEligible - Whether the video is eligible for Shorts
hasCaption - Whether the video has captions
playableInEmbed - Whether the video can be embedded

Error Responses

Status Code: 400 Bad Request

Description: The request was invalid or malformed.

{
  "error": {
    "code": 400,
    "message": "Invalid video ID format",
    "details": "Video ID must be a valid YouTube video identifier"
  }
}