innertubei 0.5.2

A fast, async-first Python library for accessing YouTube's internal API (Innertube) - search, videos, playlists, channels, transcripts, and more.

innertubei

Fast, async-first Python library for YouTube's internal API (Innertube)

Installation

Using uv (recommended)

uv add innertubei

Using pip

pip install innertubei

Quick Start

import asyncio
from innertubei import Search, Video, Playlist, Transcript, Suggestions

async def main():
    # Search videos, channels, playlists
    search = Search('NoCopyrightSounds', limit=5)
    results = await search.next()

    # Get video details + formats
    video = await Video.get('E07s5ZYygMg')

    # Get playlist info + videos
    playlist = await Playlist.get('PLRBp0Fe2GpgmsW46rJyudVFlY6IYjFBIK')

    # Get video transcript
    transcript = await Transcript.get('https://www.youtube.com/watch?v=E07s5ZYygMg')

    # Get search suggestions
    suggestions = await Suggestions.get('python tutorial')

asyncio.run(main())

For detailed examples, see example.py.

Development

Using uv (recommended)

# Clone and setup
git clone https://github.com/ohmyarthur/innertubei
cd innertubei
uv sync

# Run examples
uv run example.py

# Run tests
uv run uv run python -m pytest

Using traditional tools

pip install -e .
python example.py

License

MIT License. See LICENSE for details.

Credits

• Based on: py-yt-search by AshokShau - the original foundation
• Maintained by: ohmyarthur
• Inspiration: youtube-search-python by Alex Mercer