yt-search-py 1.0.0__tar.gz

yt_search_py-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Sparrow
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

yt_search_py-1.0.0/MANIFEST.in

@@ -0,0 +1,6 @@
+include README.md
+include LICENSE
+recursive-include ytSearch *.py
+recursive-exclude tests *
+recursive-exclude examples *
+exclude .gitignore

yt_search_py-1.0.0/PKG-INFO

@@ -0,0 +1,107 @@
+Metadata-Version: 2.4
+Name: yt-search-py
+Version: 1.0.0
+Summary: Lightweight YouTube search library with async support - Search for videos, channels, playlists and get playlist details
+Author-email: Sparrow <108956698+sparrow9616@users.noreply.github.com>
+License: MIT
+Project-URL: Homepage, https://github.com/sparrow9616/yt-search
+Project-URL: Documentation, https://github.com/sparrow9616/yt-search/blob/main/README.md
+Project-URL: Repository, https://github.com/sparrow9616/yt-search
+Project-URL: Bug Tracker, https://github.com/sparrow9616/yt-search/issues
+Keywords: youtube,search,youtube-search,playlist,async,youtube-api
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Multimedia :: Video
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx>=0.28.1
+Dynamic: license-file
+
+# YT Search
+
+A lightweight, modern YouTube search library with async/await support. Search for videos, channels, playlists, and retrieve complete playlist information with ease.
+
+[![PyPI version](https://badge.fury.io/py/yt-search-lite.svg)](https://pypi.org/project/yt-search-lite/)
+[![Python](https://img.shields.io/pypi/pyversions/yt-search-lite.svg)](https://pypi.org/project/yt-search-lite/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## 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
+
+```bash
+pip install yt-search
+```
+
+## Quick Start
+
+### Search for Videos
+
+```python
+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
+
+```python
+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](LICENSE) file for details.

yt_search_py-1.0.0/README.md

@@ -0,0 +1,77 @@
+# YT Search
+
+A lightweight, modern YouTube search library with async/await support. Search for videos, channels, playlists, and retrieve complete playlist information with ease.
+
+[![PyPI version](https://badge.fury.io/py/yt-search-lite.svg)](https://pypi.org/project/yt-search-lite/)
+[![Python](https://img.shields.io/pypi/pyversions/yt-search-lite.svg)](https://pypi.org/project/yt-search-lite/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## 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
+
+```bash
+pip install yt-search
+```
+
+## Quick Start
+
+### Search for Videos
+
+```python
+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
+
+```python
+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](LICENSE) file for details.

yt_search_py-1.0.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "yt-search-py"
+version = "1.0.0"
+description = "Lightweight YouTube search library with async support - Search for videos, channels, playlists and get playlist details"
+readme = "README.md"
+requires-python = ">=3.7"
+license = {text = "MIT"}
+keywords = ["youtube", "search", "youtube-search", "playlist", "async", "youtube-api"]
+authors = [
+    {name = "Sparrow", email = "108956698+sparrow9616@users.noreply.github.com"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Multimedia :: Video",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+]
+dependencies = [
+    "httpx>=0.28.1",
+]
+
+[project.urls]
+Homepage = "https://github.com/sparrow9616/yt-search"
+Documentation = "https://github.com/sparrow9616/yt-search/blob/main/README.md"
+Repository = "https://github.com/sparrow9616/yt-search"
+"Bug Tracker" = "https://github.com/sparrow9616/yt-search/issues"
+
+[tool.setuptools.packages.find]
+include = ["ytSearch*"]
+exclude = ["tests*", "examples*"]
+
+[tool.setuptools.package-data]
+ytSearch = ["py.typed"]

yt_search_py-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

yt_search_py-1.0.0/ytSearch/__init__.py

@@ -0,0 +1,9 @@
+from ytSearch.search import *
+from ytSearch.playlist import Playlist
+from ytSearch.core.constants import *
+
+
+__title__        = 'ytSearch'
+__version__      = '1.0.0'
+__author__       = 'sparrow9616'
+__license__      = 'MIT'

yt_search_py-1.0.0/ytSearch/core/constants.py

@@ -0,0 +1,74 @@
+requestPayload = {
+    "context": {
+        "client": {
+            "clientName": "WEB",
+            "clientVersion": "2.20210224.06.00",
+            "newVisitorCookie": True,
+        },
+        "user": {
+            "lockedSafetyMode": False,
+        }
+    }
+}
+userAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/70.0.3538.77 Safari/537.36'
+
+
+videoElementKey = 'videoRenderer'
+channelElementKey = 'channelRenderer'
+playlistElementKey = 'playlistRenderer'
+shelfElementKey = 'shelfRenderer'
+itemSectionKey = 'itemSectionRenderer'
+continuationItemKey = 'continuationItemRenderer'
+playerResponseKey = 'playerResponse'
+richItemKey = 'richItemRenderer'
+hashtagElementKey = 'hashtagTileRenderer'
+hashtagBrowseKey = 'FEhashtag'
+hashtagVideosPath = ['contents', 'twoColumnBrowseResultsRenderer', 'tabs', 0, 'tabRenderer', 'content', 'richGridRenderer', 'contents']
+hashtagContinuationVideosPath = ['onResponseReceivedActions', 0, 'appendContinuationItemsAction', 'continuationItems']
+searchKey = 'AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8'
+contentPath = ['contents', 'twoColumnSearchResultsRenderer', 'primaryContents', 'sectionListRenderer', 'contents']
+fallbackContentPath = ['contents', 'twoColumnSearchResultsRenderer', 'primaryContents', 'richGridRenderer', 'contents']
+continuationContentPath = ['onResponseReceivedCommands', 0, 'appendContinuationItemsAction', 'continuationItems']
+continuationKeyPath = ['continuationItemRenderer', 'continuationEndpoint', 'continuationCommand', 'token']
+playlistInfoPath = ['response', 'sidebar', 'playlistSidebarRenderer', 'items']
+playlistVideosPath = ['response', 'contents', 'twoColumnBrowseResultsRenderer', 'tabs', 0, 'tabRenderer', 'content', 'sectionListRenderer', 'contents', 0, 'itemSectionRenderer', 'contents', 0, 'playlistVideoListRenderer', 'contents']
+playlistPrimaryInfoKey = 'playlistSidebarPrimaryInfoRenderer'
+playlistSecondaryInfoKey = 'playlistSidebarSecondaryInfoRenderer'
+playlistVideoKey = 'playlistVideoRenderer'
+
+
+class ResultMode:
+    json = 0
+    dict = 1
+
+
+class SearchMode:
+    videos = 'EgIQAQ%3D%3D'
+    channels = 'EgIQAg%3D%3D'
+    playlists = 'EgIQAw%3D%3D'
+    livestreams = 'EgJAAQ%3D%3D'
+
+
+class VideoUploadDateFilter:
+    lastHour = 'EgQIARAB'
+    today = 'EgQIAhAB'
+    thisWeek = 'EgQIAxAB'
+    thisMonth = 'EgQIBBAB'
+    thisYear = 'EgQIBRAB'
+
+
+class VideoDurationFilter:
+    short = 'EgQQARgB'
+    long = 'EgQQARgC'
+
+
+class VideoSortOrder:
+    relevance = 'CAASAhAB'
+    uploadDate = 'CAISAhAB'
+    viewCount = 'CAMSAhAB'
+    rating = 'CAESAhAB'
+
+
+class ChannelRequestType:
+    info = "EgVhYm91dA%3D%3D"
+    playlists = "EglwbGF5bGlzdHMYAyABcAA%3D"