simple-yt-api 1.0.2

A simple and easy-to-use YouTube API Wrapper

Simple YouTube API

A lightweight Python wrapper for extracting video metadata and transcripts from YouTube videos.

Features

• 🎥 Extract video metadata (title, thumbnail, description)
• 📝 Get video transcripts in multiple languages
• ⚡ Simple and easy to use interface
• 🔒 No API key required
• 🌐 Support for both YouTube URL formats (youtube.com and youtu.be)

Installation

pip install simple-yt-api

Quick Start

from simple_yt_api import YouTubeAPI

# Initialize with a YouTube URL
url = "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
yt = YouTubeAPI(url)

# Get video metadata
metadata = yt.data()
print(metadata['title'])

# Get video transcript
transcript = yt.get_transcript(languages=['en'])  # Get English transcript
print(transcript)

# Get both metadata and transcript at once
data, transcript = yt.get_video_data_and_transcript(
    languages=['en', 'tr'],  # Priority languages
    as_dict=False  # Return transcript as plain text
)

API Reference

YouTubeAPI Class

YouTubeAPI(url: str)

Initialize the API with a YouTube video URL.

data() -> dict

Returns video metadata dictionary containing:

• video_id: YouTube video ID
• title: Video title
• img_url: Thumbnail URL
• short_description: Video description

get_transcript(languages: list = [], as_dict: bool = False) -> str | dict

Get video transcript in specified languages.

• languages: List of language codes (e.g., ['en', 'tr'])
• as_dict: If True, returns timestamp dictionary format

get_video_data_and_transcript(languages: list = [], as_dict: bool = False) -> tuple

Returns both video metadata and transcript for a YouTube video in one call without worrying about errors.

Error Handling

The library includes custom exceptions:

• NotValidURL: Invalid YouTube URL format
• NoVideoFound: Video not accessible or doesn't exist
• NoTranscriptFound: No transcript available for the video

Requirements

• requests>=2.32.3
• beautifulsoup4>=4.13.3
• youtube-transcript-api>=0.6.3

License

This project is licensed under the MIT License.