PyTubeSearch v1.0.0 - Initial Release

🔍 PyTubeSearch v1.0.0

🎉 The first stable release of PyTubeSearch - A powerful Python package for searching YouTube content!

Unlock the power of YouTube search with lightning-fast Python integration. This initial release provides comprehensive YouTube search capabilities with a simple, developer-friendly interface.

🚀 What's Included

Core Features

• 🎯 Keyword Search: Search YouTube videos, channels, playlists by keywords
• 📹 Video Details: Get comprehensive video information including metadata
• 📋 Playlist Support: Extract playlist contents and metadata
• 📺 Channel Information: Retrieve channel details and content
• 🩳 YouTube Shorts: Access YouTube Shorts content
• 📄 Pagination: Handle large result sets with next page functionality
• 💡 Homepage Suggestions: Get YouTube homepage suggestions

Developer Experience

• 🚀 Fast & Reliable: Built with httpx for high performance
• 🔧 Type Safe: Full Pydantic model support with type hints
• 🎛️ Flexible Options: Filter by content type (video, channel, playlist, movie)
• 🔄 Context Manager Support: Clean resource management
• ⚡ Async Ready: Built for modern Python applications

📦 Installation

pip install pytubesearch

🎯 Quick Example

from pytubesearch import PyTubeSearch

with PyTubeSearch() as client:
    results = client.search("python programming", limit=10)

    for video in results.items:
        if video.type == "video":
            print(f"📹 {video.title} by {video.channel_title}")

🔧 Requirements

• Python 3.8+
• httpx >= 0.24.0
• pydantic >= 2.0.0

📚 Documentation

Complete documentation and examples are available in the ./examples/ directory and README.md.

🤝 Contributing

Contributions are welcome! Please see our contributing guidelines in the README.md file.

🙏 Acknowledgements

Special thanks to YouTube for the platform, the Python community for amazing tools, and all open-source contributors. This project is for educational purposes - please respect YouTube's Terms of Service and use responsibly.

Give it a ⭐ on GitHub if PyTubeSearch helps your project!