The YouTube Object: InnerTube's Central API Entry Point

// Access is always through the singleton — no constructor needed
YouTube.locale = YouTubeLocale(gl = "US", hl = "en")
YouTube.cookie = "SAPISID=..."

Your App Code
     │
     ▼
YouTube  (high-level: parses JSON → typed Page objects)
     │
     ▼
InnerTube  (low-level: Ktor/OkHttp HTTP client, request bodies, headers)
     │
     ▼
https://music.youtube.com/youtubei/v1/

// ✅ Inside a coroutine scope
viewModelScope.launch {
    val result = YouTube.search("Daft Punk", SearchFilter.FILTER_SONG)
}

// ❌ This will not compile — search is a suspend function
val result = YouTube.search("Daft Punk", SearchFilter.FILTER_SONG)

// ✅ createPlaylist is NOT suspend — it uses runBlocking internally
val playlistId: String = YouTube.createPlaylist("My Playlist")

viewModelScope.launch {
    val result: Result<SearchResult> = YouTube.search("Daft Punk", SearchFilter.FILTER_SONG)

    result
        .onSuccess { searchResult ->
            val songs = searchResult.items.filterIsInstance<SongItem>()
            println("Found ${songs.size} songs")
            songs.forEach { println("  ${it.title} — ${it.artists.joinToString { a -> a.name }}") }

            // If there are more pages, searchResult.continuation is non-null
            searchResult.continuation?.let { token ->
                val nextPage = YouTube.searchContinuation(token).getOrNull()
                // ... handle next page
            }
        }
        .onFailure { error ->
            println("Search failed: ${error.message}")
        }
}