Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/faraasaaay/innertube-v2/llms.txt

Use this file to discover all available pages before exploring further.

InnerTube is a Kotlin Android library that provides a clean, high-level interface to YouTube’s internal InnerTube API. Use it to build YouTube Music clients, playlist managers, or any app that needs structured access to YouTube Music data — search, playback streams, artist and album metadata, user library, comments, and more.

Quickstart

Add the library and make your first API call in minutes

Configuration

Set locale, authentication, proxy, and IP version options

YouTube Object

Learn how the central YouTube singleton works

API Reference

Full reference for every method and data model

​
What InnerTube Does

The library exposes a single YouTube Kotlin object with suspend functions covering the full YouTube Music surface:

Search

Search songs, videos, albums, artists, and playlists with typed filters

Playback

Resolve authenticated stream URLs with multi-client fallback

Browse

Fetch home feed, explore, charts, mood & genres

Playlists

Create, edit, and manage playlists and their songs

Library

Access user library, history, and liked content

Comments

Fetch comments and replies with pagination

​
Get Started

1

Add the dependency

Include the InnerTube module in your Android project’s build.gradle.kts.
2

Configure the YouTube object

Set your locale, and optionally supply a cookie string for authenticated access.
3

Call your first method

Use YouTube.search() or YouTube.home() to start fetching data.
4

Handle playback

Use YouTube.player() with the right YouTubeClient to resolve stream URLs.
InnerTube targets Android API 26+ and requires Kotlin coroutines. All YouTube methods are suspend functions — call them from a coroutine scope.

Build docs developers (and LLMs) love

Get started for freeTalk to us