PortableInnertube: cross-platform KMP API reference

import com.tamed.music.innertube.PortableInnertube
import com.tamed.music.innertube.models.YouTubeLocale

val client = PortableInnertube(
    locale = YouTubeLocale(gl = "US", hl = "en-US")
)

import com.tamed.music.innertube.PlaybackAuthState

client.applyAuthState(
    PlaybackAuthState(
        cookie = "SAPISID=xxx; HSID=yyy; ...",
        visitorData = "CgtAbCdEfGhIjKlMnO",
        dataSyncId = "your_data_sync_id",
        webClientPoTokenEnabled = true,
        poTokenPlayer = "player_token_here",
        poTokenGvs = "gvs_token_here",
    )
)

val state: PlaybackAuthState = client.currentAuthState()
println("Logged in: ${state.hasLoginCookie}")
println("Session ID: ${state.sessionId}")

val result = client.search("Tame Impala").getOrThrow()
result.items.forEach { println(it.title) }

// Pagination
var continuation = result.continuation
while (continuation != null) {
    val next = client.search("Tame Impala", continuation = continuation).getOrThrow()
    next.items.forEach { println(it.title) }
    continuation = next.continuation
}

val suggestions = client.searchSuggestions("billie ei").getOrThrow()
suggestions.queries.forEach { println(it) }

val page = client.playlist("PLxxxxxxxxxxxxxx").getOrThrow()
println(page.playlist.title)
page.songs.forEach { println(it.title) }

// In commonMain shared code (Kotlin)
class MusicRepository(private val inner: PortableInnertube) {

    suspend fun fetchArtist(browseId: String): ArtistPage {
        return inner.artist(browseId).getOrThrow()
    }

    suspend fun fetchAlbum(browseId: String): AlbumPage {
        return inner.album(browseId, withSongs = true).getOrThrow()
    }

    suspend fun searchAll(query: String): List<YTItem> {
        return inner.search(query).getOrThrow().items
    }
}

// Swift (iOS)
let inner = PortableInnertube(
    locale: YouTubeLocale(gl: "US", hl: "en-US")
)

let repo = MusicRepository(inner: inner)

Task {
    let artist = try await repo.fetchArtist(browseId: "UCxxxxxxxxxxxxxxxxxxxxxx")
    print(artist.artist.title)
    for section in artist.sections {
        print(section.title, section.items.count)
    }
}