YouTube

YouTube Video Details

Get structured details for a YouTube video — title, channel, view count, length, description, keywords, chapters, and available captions — as JSON. The legacy /api/v1/youtube/metadata path and youtube.metadata() method remain as deprecated aliases of this endpoint.

POST/api/v1/youtube/video

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

video_idstringrequired

The YouTube video id (11 characters), or a full watch URL (the id is extracted server-side).

Example: sVcwVQRHIc8

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")
results = client.youtube.video(video_id="sVcwVQRHIc8")
print(results)

Response

"video_id": "sVcwVQRHIc8",

"title": "Learn RAG From Scratch – Python AI Tutorial from a LangChain Engineer",

"author": "freeCodeCamp.org",

"channel_id": "UC8butISFwT-Wl7EV0hUK0BQ",

"channel_url": "https://www.youtube.com/channel/UC8butISFwT-Wl7EV0hUK0BQ",

"published_at": "2024-04-17T06:54:43-07:00",

"description": "Learn how to implement RAG (Retrieval Augmented Generation) from scratch, straight from a LangChain software engineer. This Python course teaches you how to use RAG to combine your own custom data with the power of Large Language Models (LLMs).",

"length_seconds": 9191,

"view_count": 1745393,

"keywords": [],

"thumbnail": "https://i.ytimg.com/vi_webp/sVcwVQRHIc8/maxresdefault.webp",

"playability_status": "OK",

"response_time": 2226,

"credits_used": 1,

"credits_remaining": 77643

}