youtubei-rs

A asynchronous implementation of the invidious innertube aka youtubei API wrapper.
Using tokio,reqwest, serde and serde_json.

Breaking changes in version bump 0.2.3 to 1.2.3

• old queries are now prefixed with _legacy, if you rely on those just rename them in your program they still function the same

Dependencies

• serde_json
• serde: features = ["derive"]
• reqwest: features = ["json","gzip"]
• tokio: features = ["full"]

Roadmap

• implementing proxy support
• removing panics
• adding more endpoints

Implemented endpoints

• next
• browse
• search
• resolve_url
• player

Supported queries

• next_video_id // Get next(aka related and comments) results for a given videoId
• next_continuation // Fetch more next(aka related and comments) results for a given ctoken
• browse_id // Get browse(aka a channel or playlist) results for a given browseId
• browse_continuation // Fetch more browse(aka a channel or playlist) results for a given ctoken
• resolve, // Resolve a given url
• player // Get player data for a given videoId

Example

use youtubei_rs::{query::player, utils::default_client_config, types::query_results::PlayerResult};
#[tokio::main]
async fn main() {
    // create default client_config with WEB client
    let client_config = &default_client_config();
    // get player for video with id gC6dQrScmHE
    let player: PlayerResult = player(String::from("gC6dQrScmHE"),String::from(""),&client_config).await.unwrap();
    println!("{}",player.video_details.title); // video title
}

With logging

For logging tracing is used so tracing_subscribe can be installed for easier use of tracing. The library has as target youtubei_rs with debug,trace and error levels.

use youtubei_rs::{query::player, utils::default_client_config};
#[tokio::main]
async fn main() {
    std::env::set_var("RUST_LOG", "youtubei_rs=debug");
    tracing_subscriber::fmt::init();
    // create default client_config with WEB client
    let client_config = &default_client_config();
    // get player for video with id gC6dQrScmHE
    let player: PlayerResult = player(String::from("gC6dQrScmHE"),String::from(""),&client_config).await.unwrap();
    println!("{}",player.video_details.title); // video title
}

Supported queries (legacy)

• get_video: Fetches all information about the video except captions and storyboards
• get_channel_info: Fetches all channel information and about tab
• get_channel_tab: Fetches a specific tab like videos to get channel videos
• search: Search youtube
• load_search: Continue search with ctoken
• get_comments: Loads initial comments or more comments for video
• load_related_videos: Loads more related videos
• get_playlist: Loads a playlist

For more in depth info take a look at query.rs and tests.rs