tubescrape

KO | EN

gitlite — search

#ai #cli #macos #python #bocaletto-luca #linux #opensource #api #llm #windows #nodejs #cpp

★ 14 Open GitHub ↗

A fast, lightweight Python toolkit for scraping YouTube without an API key. Search videos with filters, browse channel content (videos, shorts, playlists), fetch and translate transcripts, and scrape full playlists

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h1 align="center">TubeScrape</h1>

Scrape YouTube search results, channels, transcripts, comments, and playlists. No API key needed.

<a href="https://zaidkx37.github.io/tubescrape/">Documentation</a> · <a href="https://pypi.org/project/tubescrape/">PyPI</a> · <a href="https://github.com/zaidkx37/tubescrape/issues">Issues</a>

---

## Install

```bash
pip install tubescrape
```

## Quick Start

```python
from tubescrape import YouTube

yt = YouTube()

# Search
results = yt.search('python tutorial', max_results=5)
for video in results.videos:
    print(video.title, video.view_count, video.is_short)

# Video info with likes, chapters, AI summary
info = yt.get_video_info('https://youtube.com/watch?v=dQw4w9WgXcQ')
print(info.like_count, info.comment_count, info.ai_summary)
for ch in info.chapters:
    print(ch.time_description, ch.title)

# Comments with replies
comments = yt.get_comments('dQw4w9WgXcQ', max_results=10, replies=True)
for c in comments.comments:
    print(c.author, c.text, c.like_count)
    for r in c.replies:
        print(f'  -> {r.author}: {r.text}')

# Channel videos, streams, shorts, playlists, about
videos = yt.get_channel_videos('@lexfridman', max_results=10)
streams = yt.get_channel_streams('@CNN', max_results=5)
shorts = yt.get_channel_shorts('@CNN', max_results=10)
about = yt.get_channel_about('@ycombinator')
print(about.country, about.joined_date, about.subscriber_count)

# Transcript
transcript = yt.get_transcript('dQw4w9WgXcQ')
print(transcript.text)
transcript.save('subtitles.srt')

# Playlist
playlist = yt.get_playlist('PLrAXtmErZgOeiKm4sgNOknGvNjby9efdf')

# Every method accepts URLs, IDs, or @handles
```

## Features

| Feature | What you get |
|---|---|
| **Search** | Videos, channels, shorts with filters (type, duration, date, sort, features) |
| **Video Info** | Title, description, views, likes, comments count, chapters, AI summary, people mentioned |
| **Comments** | Top-level comments with likes, replies, author info, hearted/verified/creator badges |
| **Channel** | Videos, live streams, shorts, playlists, search within channel, about/info page |
| **Transcripts** | Fetch, translate, format (SRT/VTT/JSON), save to file |
| **Playlists** | Full pagination with metadata |
| **Async** | Every method has an `async` variant (`asearch`, `aget_video_info`, etc.) |
| **Proxies** | Rotation, separate transcript proxy pool for mass scraping |

## How It Works

Uses YouTube's internal InnerTube API (the same endpoints the YouTube web client uses). No API key, no OAuth, no Google account required. Only dependency is `httpx`.

## CLI

```bash
pip install "tubescrape[cli]"

tubescrape search "python tutorial" -n 5
tubescrape channel @lexfridman
tubescrape transcript dQw4w9WgXcQ --format srt --save output.srt
```

## REST API

```bash
pip install "tubescrape[api]"

tubescrape serve                    # localhost:8000
```

Swagger docs at `http://localhost:8000/docs`.

## Documentation

For complete API reference, all parameters, return types, code examples, and advanced usage:

**[Read the full documentation](https://zaidkx37.github.io/tubescrape/)**

## Warning

This library uses YouTube's undocumented InnerTube API. It may break if YouTube changes their internal API. If it does, please [open an issue](https://github.com/zaidkx37/tubescrape/issues).

## License

MIT

tubescrape

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README