Metadata-Version: 2.4
Name: tube-search
Version: 0.0.2
Summary: 🔎 Search for videos, channels and playlists on YouTube quickly and easily.
Author: BubbalooTeam
Author-email: bubbalooteam@proton.me
License: MIT License
Keywords: tube search,tube_search
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx[http2]
Dynamic: author
Dynamic: author-email
Dynamic: description
Dynamic: description-content-type
Dynamic: keywords
Dynamic: license
Dynamic: license-file
Dynamic: requires-dist
Dynamic: summary

# Tube Search - Youtube fast and practical search engine in Python

<img height="80" align="right" alt="Tube Search" src="https://i.ibb.co/wNbhxXtf/20250512-123905-0000.png"/>

> Tube Search is an asynchronous, constantly up-to-date and written python library, aiming to do research simply, practically and quickly on YouTube.

# Search for Video (1 Video):

```python
from asyncio import run
from tube_search import VideoSearch

async def main() -> None:
    video = await VideoSearch().video(
        query="Elektronomia",
        language="en-US",
        region="US"
    )
    print(video)
    print()
    print(video.videoTitle)

run(main())
```

# Output from search video (1 video):

```sh
$ TubeVideoInfo(videoID='TW9d8vYrVFQ', videoTitle='Elektronomia - Sky High | Progressive House | NCS - Copyright Free Music', videoDuration='3:58', publishedTime='8 years ago', videoViewCount=TubeViewsInfo(view_count='264,461,922 views', view_abbr_count='264M views'), thumbnails=[TubeThumbnailsInfo(url='https://i.ytimg.com/vi/TW9d8vYrVFQ/hqdefault.jpg?sqp=-oaymwEcCOADEI4CSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDzHv6boRaBnEoZWSNFdZRGVdUmJw', width=480, height=270)], descriptionSnippet='#nocopyrightsounds #copyrightfree #music #song #edm #dancemusic #royaltyfreemusic #copyrightfreemusic #nocopyrightmusic\xa0...', channel=TubeChannelInfo(title='NoCopyrightSounds', id='UC_aEa8K-EOJ3D6gOs7HcyNg', thumbnails=[TubeThumbnailsInfo(url='https://yt3.ggpht.com/opGwWu2ScRBy-OA81LIzKwSatxlVKjjNyAdt4fWh4LoLzldx05Sdf3OGQz0Fz78ziZ9RLP4=s68-c-k-c0x00ffffff-no-rj', width=68, height=68)], url='https://www.youtube.com/channel/UC_aEa8K-EOJ3D6gOs7HcyNg'), accessibility=TubeAccessibilityInfo(title='Elektronomia - Sky High | Progressive House | NCS - Copyright Free Music 3 minutes, 58 seconds', duration='3 minutes, 58 seconds'), url='https://www.youtube.com/watch?v=TW9d8vYrVFQ', shelfTitle=None)

$ Elektronomia - Sky High | Progressive House | NCS - Copyright Free Music
```

# Search for Videos (2 or more videos):

```python
from asyncio import run
from tube_search import VideoSearch

async def main() -> None:
    video = await VideoSearch().videos(
        query="Elektronomia",
        language="en-US",
        region="US",
        limit=3
    )
    print(len(video))
    print(video)

run(main())
```

# Output fron search videos (2 or more vídeos):

```sh
$ 2
$ [TubeVideoInfo(videoID='TW9d8vYrVFQ', videoTitle='Elektronomia - Sky High | Progressive House | NCS - Copyright Free Music', videoDuration='3:58', publishedTime='8 years ago', videoViewCount=TubeViewsInfo(view_count='264,729,531 views', view_abbr_count='264M views'), thumbnails=[TubeThumbnailsInfo(url='https://i.ytimg.com/vi/TW9d8vYrVFQ/hqdefault.jpg?sqp=-oaymwEcCOADEI4CSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDzHv6boRaBnEoZWSNFdZRGVdUmJw', width=480, height=270)], descriptionSnippet='#nocopyrightsounds #copyrightfree #music #song #edm #dancemusic #royaltyfreemusic #copyrightfreemusic #nocopyrightmusic\xa0...', channel=TubeChannelInfo(title='NoCopyrightSounds', id='UC_aEa8K-EOJ3D6gOs7HcyNg', thumbnails=[TubeThumbnailsInfo(url='https://yt3.ggpht.com/opGwWu2ScRBy-OA81LIzKwSatxlVKjjNyAdt4fWh4LoLzldx05Sdf3OGQz0Fz78ziZ9RLP4=s68-c-k-c0x00ffffff-no-rj', width=68, height=68)], url='https://www.youtube.com/channel/UC_aEa8K-EOJ3D6gOs7HcyNg'), accessibility=TubeAccessibilityInfo(title='Elektronomia - Sky High | Progressive House | NCS - Copyright Free Music 3 minutes, 58 seconds', duration='3 minutes, 58 seconds'), url='https://www.youtube.com/watch?v=TW9d8vYrVFQ', shelfTitle=None), TubeVideoInfo(videoID='IvVgQHZtpQE', videoTitle='Best of Elektronomia 2018 | Top 20 Songs of Elektronomia', videoDuration='1:19:17', publishedTime='6 years ago', videoViewCount=TubeViewsInfo(view_count='3,551,520 views', view_abbr_count='3.5M views'), thumbnails=[TubeThumbnailsInfo(url='https://i.ytimg.com/vi/IvVgQHZtpQE/hq720.jpg?sqp=-oaymwEcCOgCEMoBSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLDMuVnG1n3vFCydcS25IoGFeATqiA', width=360, height=202), TubeThumbnailsInfo(url='https://i.ytimg.com/vi/IvVgQHZtpQE/hq720.jpg?sqp=-oaymwEcCNAFEJQDSFXyq4qpAw4IARUAAIhCGAFwAcABBg==&rs=AOn4CLA3EB6Wp6JT-cDSieyTiTqWcFTCVA', width=720, height=404)], descriptionSnippet='Elektronomia Top 20 | Best of Elektronomia 2018 Please help Musicbot reach 100k subscriber by join at\xa0...', channel=TubeChannelInfo(title='Musicbot', id='UCDsbBjIl0lYZB4IokDLyWIQ', thumbnails=[TubeThumbnailsInfo(url='https://yt3.ggpht.com/ytc/AIdro_nqKHLecROII_Q_UJTkPI6W7C-6hlXCPzpVwDwBU7E4x2o=s68-c-k-c0x00ffffff-no-rj', width=68, height=68)], url='https://www.youtube.com/channel/UCDsbBjIl0lYZB4IokDLyWIQ'), accessibility=TubeAccessibilityInfo(title='Best of Elektronomia 2018 | Top 20 Songs of Elektronomia 1 hour, 19 minutes', duration='1 hour, 19 minutes, 17 seconds'), url='https://www.youtube.com/watch?v=IvVgQHZtpQE', shelfTitle=None)]
```
