YouTube Transcript API JSON
Understand the JSON response shape for TubeScript transcript requests, including metadata, segments, source type, and errors.
Direct answer
The real endpoint is https://tubescript.cc/v1/transcript. API access is included with the Team plan.
YouTube Transcript API JSON
TubeScript returns a JSON envelope with success, data, and error fields. Successful responses include video_id, video_title, channel_name, language, transcript_source, word_count, segments, cached, and permalink.
{
"success": true,
"data": {
"video_id": "dQw4w9WgXcQ",
"video_title": "Video Title",
"channel_name": "Channel Name",
"video_duration": 212,
"language": "en",
"transcript_source": "youtube_auto",
"word_count": 1847,
"read_time_minutes": 8,
"segments": [
{ "start": 0, "duration": 4.2, "text": "First transcript segment" }
],
"cached": false,
"permalink": "https://tubescript.cc/transcript/dQw4w9WgXcQ"
}
}Segments are timestamped
Each segment has a start time in seconds, a duration, and text. That is the primitive for citations, chapters, subtitles, and search.
Errors stay structured
Failed requests return success false and an error object with a code and message so callers can retry, fall back, or show a user-facing reason.
Build on the transcript engine
Team includes API keys, JSON transcript access, cache-backed reads, and 100 API requests per day.
View Pricing