GeniusAPI 1.1.1

dotnet add package GeniusAPI --version 1.1.1                
NuGet\Install-Package GeniusAPI -Version 1.1.1                
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="GeniusAPI" Version="1.1.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add GeniusAPI --version 1.1.1                
#r "nuget: GeniusAPI, 1.1.1"                
#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 GeniusAPI as a Cake Addin
#addin nuget:?package=GeniusAPI&version=1.1.1

// Install GeniusAPI as a Cake Tool
#tool nuget:?package=GeniusAPI&version=1.1.1                

GeniusAPI

This Genius API wrapper allows you to easily search for tracks on Genius. It also provides lyrics/genres fetching using web scraping.


How to use?

Search for tracks on Genius:

using GeniusAPI;
using GeniusAPI.Models;

GeniusClient client = new("<GENIUS ACCESS TOKEN>");
IEnumerable<GeniusTrack> tracks = await client.SearchTracksAsync("<SEARCH QUERRY>");

Fetch lyrics of a track:

using GeniusAPI;
using GeniusAPI.Models;

GeniusClient client = new("<YOUR GENIUS ACCESS TOKEN>");
string? lyrics = await client.FetchLyricsAsync("<GENIUS TRACK URL>");

Fetch genres of a track:

using GeniusAPI;
using GeniusAPI.Models;

GeniusClient client = new("<YOUR GENIUS ACCESS TOKEN>");
IEnumerable<string>? genres = await client.FetchGenresAsync("<GENIUS TRACK URL>");

Get track info (search for track & additionally fetch the lyrics/genres):

using GeniusAPI;
using GeniusAPI.Models;

GeniusClient client = new("<YOUR GENIUS ACCESS TOKEN>");
GeniusTrackInfo? trackInfo = await client.GetTrackInfoAsync("<TRACK TITLE>", "<TRACK ARTIST>");

GeniusTrack track = trackInfo.Track;
string lyrics? = trackInfo?.Lyrics;
IEnumerable<string>? genres = trackInfo?.Genres;

How to get an acces token?

You can learn how to get a free access token on the offical Genius API documentation: https://genius.com/api-clients

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  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.1.1 116 7/28/2024
1.1.0 120 7/21/2024
1.0.2 97 7/20/2024
1.0.1 106 7/20/2024
1.0.0 98 7/20/2024

- Replaced all throwed excpetions with returning null