youtubei.js

A JavaScript client for YouTube's private API

YouTube.js is a JavaScript client for YouTube's private API, known as "InnerTube". It allows you to interact with YouTube programmatically, providing access to videos, comments, live chats, streaming data and more. It works seamlessly across Node.js, Deno, and modern browsers.

Installation

Before installing, make sure your environment meets the prerequisites.

# NPM
npm install youtubei.js@latest

# Yarn
yarn add youtubei.js@latest

# Git (edge version)
npm install github:LuanRT/YouTube.js

# Deno
deno add npm:youtubei.js@latest

Deno (deprecated):

import { Innertube } from 'https://deno.land/x/youtubei/deno.ts';

Basic Usage

// const { Innertube } = require('youtubei.js');
import { Innertube } from 'youtubei.js';
const innertube = await Innertube.create(/* options */);

For detailed usage, check out the YouTube.js Guide and API Documentation.

Contributing

We welcome all contributions, issues and feature requests, whether small or large. If you want to contribute, feel free to check out our issues page and our guidelines.

Contributors

Disclaimer

This project is not affiliated with, endorsed, or sponsored by YouTube or any of its affiliates or subsidiaries. All trademarks, logos, and brand names used in this project are the property of their respective owners and are used solely to describe the services provided.

As such, any usage of trademarks to refer to such services is considered nominative use. If you have any questions or concerns, please contact me.

License

Distributed under the MIT License.

(back to top)

Changelog

14.0.0 (2025-06-08)

⚠ BREAKING CHANGES

• StreamingInfoOptions: Add is_sabr option (#974)

Features

• Add TV_SIMPLY client (8cf6581)
• MediaInfo: Add updateWatchTime (#874) (065e9a4)
• StreamingInfoOptions: Add is_sabr option (#974) (561e60b)
• VideoInfo: implement MacroMarkersListEntity parser for heatmap (#973) (876e94a)

Bug Fixes

• add missing TV_SIMPLY parts on some files (#975) (689fb0b)
• Constants: Add TVHTML5_SIMPLY to CLIENT_NAME_IDS (b15f623)
• getBasicInfo: Add racyCheckOk and contentCheckOk to payload (#961) (0f1fd72)
• Handle CommandExecutorCommand in NavigationEndpoint.call (#968) (698121a)
• Innertube: Properly encoded params in getPostComments() (#955) (92b8623)
• Session: Initialize client version based on provided client name (#971) (bb022e8)