Skip to main content
GET
https://api.scriptbase.app
/
api
/
v1
/
videos
/
{id}
curl "https://api.scriptbase.app/api/v1/videos/dQw4w9WgXcQ" \
  -H "X-API-Key: sk_your_key_here"
{
  "success": true,
  "data": {
    "id": "dQw4w9WgXcQ",
    "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
    "description": "The official video for Rick Astley...",
    "duration": 213,
    "channel": {
      "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "name": "Rick Astley"
    },
    "tags": [],
    "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
    "uploadDate": "2009-10-25T06:57:33.000Z",
    "viewCount": "1500000000",
    "likeCount": "15000000",
    "transcriptLanguages": []
  },
  "meta": {
    "creditsUsed": 1,
    "creditsRemaining": 999,
    "rateLimit": {
      "limit": 60,
      "remaining": 59,
      "resetAt": 1704326400
    }
  }
}

Overview

Fetch comprehensive metadata for a single YouTube video including title, description, channel information, statistics, and optionally the transcript.

Authentication

X-API-Key
string
required
Your API key

Path Parameters

id
string
required
YouTube video ID (11 characters) or full YouTube URL

Query Parameters

includeTranscript
boolean
default:"false"
Include video transcript in response. Increases credit cost from 1 to 2.
transcriptLang
string
default:"en"
Preferred language code for transcript (ISO 639-1, e.g., ‘en’, ‘es’, ‘fr’)

Credits

  • Without transcript: 1 credit
  • With transcript: 2 credits

Response

success
boolean
Whether the request was successful
data
object
meta
object
curl "https://api.scriptbase.app/api/v1/videos/dQw4w9WgXcQ" \
  -H "X-API-Key: sk_your_key_here"
{
  "success": true,
  "data": {
    "id": "dQw4w9WgXcQ",
    "title": "Rick Astley - Never Gonna Give You Up (Official Music Video)",
    "description": "The official video for Rick Astley...",
    "duration": 213,
    "channel": {
      "id": "UCuAXFkgsw1L7xaCfnd5JJOw",
      "name": "Rick Astley"
    },
    "tags": [],
    "thumbnail": "https://i.ytimg.com/vi/dQw4w9WgXcQ/maxresdefault.jpg",
    "uploadDate": "2009-10-25T06:57:33.000Z",
    "viewCount": "1500000000",
    "likeCount": "15000000",
    "transcriptLanguages": []
  },
  "meta": {
    "creditsUsed": 1,
    "creditsRemaining": 999,
    "rateLimit": {
      "limit": 60,
      "remaining": 59,
      "resetAt": 1704326400
    }
  }
}

Error Codes

StatusCodeDescription
400INVALID_VIDEO_IDVideo ID format is invalid
401INVALID_API_KEYAPI key is missing or invalid
404NOT_FOUNDVideo not found or unavailable
429QUOTA_EXCEEDEDMonthly quota exhausted
429RATE_LIMIT_EXCEEDEDToo many requests