Home

Introduction

ytsearch.js is a lightweight Node.js library to fetch YouTube videos, channels, playlists, movies, and live streams without using the official YouTube API. It provides:

• Simple async API for Node.js (ESM & CommonJS)
• Pagination support for playlists and search results
• Metadata tracking for both YouTube pages and user-requested pages
• Standardized error handling with YtSearchError

For full documentation, navigate through the pages listed in the Table of Contents.

---

Table of Contents

1. Introduction
2. Getting Started
3. searchYouTube API
4. getPlaylistItems API
5. getVideoDetails API
6. Error Handling
7. TypeScript Usage Guide
8. Examples