YTSearch.NET 1.0.2

There is a newer version of this package available.
See the version list below for details.
dotnet add package YTSearch.NET --version 1.0.2                
NuGet\Install-Package YTSearch.NET -Version 1.0.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="YTSearch.NET" Version="1.0.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add YTSearch.NET --version 1.0.2                
#r "nuget: YTSearch.NET, 1.0.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install YTSearch.NET as a Cake Addin
#addin nuget:?package=YTSearch.NET&version=1.0.2

// Install YTSearch.NET as a Cake Tool
#tool nuget:?package=YTSearch.NET&version=1.0.2                

YTSearch.NET

A simple .NET library that searches YouTube for video results and video data.

Installation

Install the package via NuGet:

PM> Install-Package YTSearch.NET

Running the project

Quickstart

Search YouTube via query

using YTSearch.NET;

var client = new YouTubeSearchClient();
var results = await client.SearchYoutube("all i want for christmas is you");

foreach (var result in a.Results)
{
    Console.WriteLine($"{result.Title} | {result.Author} | {result.Length:mm\\:ss}");
}

/*
Mariah Carey - All I Want for Christmas Is You (Make My Wish Come True Edition) | Mariah Carey | 04:03
Mariah Carey - All I Want For Christmas Is You (Official Video) | Mariah Carey | 03:55
Mariah Carey - All I Want For Christmas Is You (Lyrics) | 7clouds | 04:02
[Playlist] must-have songs on this christmas ?? christmas medley 2021 | are you happy? | 50:16
All I Want For Christmas Is You |  La Portella tancek dance | Tanecná skola La Portella | 03:56
All I Want For Christmas Is You (SuperFestive!) (Shazam Version) | Justin Bieber | 04:14
????? ??? ??? ?? `All I Want for Christmas Is You?'?2021 SBS ????(2021sbsgayo)?SBS ENTER. | SBS Entertainment | 03:55
Mariah Carey, Ariana Grande, Justin Bieber Christmas Songs - Top Pop Christmas Songs Playlist 2020 | Dautay vlog | 05:47
Mariah Carey - All I Want for Christmas Is You (Official Audio) | Nielson Lucas | 04:02
All I Want For Christmas Is You | Live Love Party | Zumba | Dance Fitness | Christmas | LIVELOVEPARTY.TV | 04:05
Fifth Harmony - All I Want for Christmas Is You (Official Video) | Fifth Harmony | 03:50
Mariah Carey - All I Want for Christmas Is You (Live at Tokyo Dome) | Mariah Carey | 04:55
All I Want For Christmas Is You - Mariah Carey (Karaoke Songs With Lyrics - Original Key) | Musisi Karaoke | 04:32
Mariah Carey - All I Want For Christmas Is You | GreGaVa Channel | 03:53
All I Want for Christmas Is You arranged by Michael Brown | Hal Leonard Concert Band | 02:54
all i want for christmas is you sped up | love. | 03:04
"All I Want For Christmas Is You" - Mariah Carey (Against The Current COVER) | Against The Current | 03:17
?10 HOURS? All I Want for Christmas Is You | 10 Hour Archive | 02:51
All I Want for Christmas Is You (SATB Choir) - Arranged by Mac Huff | Hal Leonard Choral | 03:45
*/

Fetch YouTube video metadata

using System;
using YTSearch.NET;

var client = new YouTubeSearchClient();
var result = (await client.GetVideoMetadataAsync(new Uri("https://www.youtube.com/watch?v=yXQViqx6GMY"))).Result;

Console.WriteLine(result.Author); // MariahCareyVEVO
Console.WriteLine(result.Category); // Music
Console.WriteLine(result.IsCrawlable); // True
Console.WriteLine(result.IsFamilyFriendly); // True
Console.WriteLine(result.IsLiveContent); // False
Console.WriteLine(result.IsPrivate); // False
Console.WriteLine(result.IsRatingEnabled); // True
Console.WriteLine(result.IsUnlisted); // False
Console.WriteLine(result.Length); // 00:03:55
Console.WriteLine(result.PublishedDate); // 23/11/2009 12:00:00 am
Console.WriteLine(result.UploadedDate); // 23/11/2009 12:00:00 am
Console.WriteLine(result.Title); // Mariah Carey - All I Want For Christmas Is You (Official Video)
Console.WriteLine(result.Url); // https://www.youtube.com/watch?v=yXQViqx6GMY
Console.WriteLine(result.VideoId); // yXQViqx6GMY
Console.WriteLine(result.Views); // 731599447

Issues and Contributing

Pull requests and issues are more than welcome.

License

This projects is licensed under the MIT License.

TODO and planned features

  • YouTube Music search
  • Search by playlist, author, etc.
  • Search video metadata
  • Add like count to video metadata
Product Compatible and additional computed target framework versions.
.NET net5.0 is compatible.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
1.0.4 212 8/19/2024
1.0.3 339 3/17/2023
1.0.2 295 1/29/2023
1.0.1 828 11/10/2022
1.0.0 378 11/2/2022

Added support for dotnet5.0