yt-search-py 1.0.0

Lightweight YouTube search library with async support - Search for videos, channels, playlists and get playlist details

YT Search

A lightweight, modern YouTube search library with async/await support. Search for videos, channels, playlists, and retrieve complete playlist information with ease.

Features

✨ Search Functionality

• 🎥 Search for videos with filters
• 👤 Search for channels
• 📝 Search for playlists
• 🔍 Custom search with sorting options
• 🔄 Pagination support

✨ Playlist Features

• 📋 Get full playlist information with videos
• ℹ️ Get playlist metadata only
• 🎬 Get playlist videos only
• ♾️ Pagination for large playlists (100+ videos)

✨ Modern API

• ⚡ Async/await support
• 🎯 Type hints
• 🚀 Fast and lightweight
• 🛡️ No API key required

Installation

pip install yt-search

Quick Start

Search for Videos

import asyncio
from ytSearch import VideosSearch

async def main():
    search = VideosSearch('Python tutorials', limit=5)
    result = await search.next()
    
    for video in result['result']:
        print(f"{video['title']} - {video['link']}")

asyncio.run(main())

Get Playlist Information

import asyncio
from ytSearch import Playlist

async def main():
    # Get full playlist with videos
    playlist = await Playlist.get('https://www.youtube.com/playlist?list=PLRBp0Fe2GpgmsW46rJyudVFlY6IYjFBIK')
    
    print(f"Playlist: {playlist['info']['title']}")
    print(f"Videos: {len(playlist['videos'])}")

asyncio.run(main())

Requirements

• Python 3.7+
• httpx >= 0.28.1

License

MIT License - see LICENSE file for details.