• v1.0.8 0d98fc2f02

    v1.0.8 Stable

    kerem released this 2023-12-10 21:06:24 +03:00 | 3 commits to main since this release

    📅 Originally published on GitHub: Sun, 10 Dec 2023 18:08:06 GMT
    🏷️ Git tag created: Sun, 10 Dec 2023 18:06:24 GMT

    Spotify Private API

    This package provides a simple way to interact with Spotify's private API. It includes methods to fetch track information and play count.

    Installation

    go get github.com/FrostBreker/spotify-private-api
    

    Usage

    import "github.com/FrostBreker/spotify-private-api"
    
    client := spotifyprivateapi.NewClient(spotifyprivateapi.Client{
    		Debug: true,
    })
    
    // Fetch track information
    track, err := client.FetchTrack("trackId")
    if err != nil {
        log.Fatal(err)
    }
    
    // Fetch track play count
    playCount, err := client.FetchTrackPlayCount("trackId")
    if err != nil {
        log.Fatal(err)
    }
    
    // Fetch artist information
    artist, err := client.FetchArtist("artistId")
    if err != nil {
        log.Fatal(err)
    }
    
    // Fetch album information
    album, err := client.FetchAlbum("albumId")
    if err != nil {
        log.Fatal(err)
    }
    
    // Search in spotify
    searchResults, err := client.Search("query")
    if err != nil {
        log.Fatal(err)
    }
    
    // Search for top results in spotify
    topTracks, err := client.SearchTopResult("query")
    if err != nil {
        log.Fatal(err)
    }
    

    Documentation

    FetchTrack(trackId string) (responseTypes.TrackResponse, error)

    FetchTrack sends a GET request to Spotify's private API to fetch information about a track. The trackId parameter is the Spotify ID of the track. It returns a TrackResponse object and an error.

    FetchTrackPlayCount(trackId string) (responseTypes.TrackPlayCount, error)

    FetchTrackPlayCount first calls FetchTrack to get the track information, then it extracts the play count from the response. The trackId parameter is the Spotify ID of the track. It returns a TrackPlayCount object and an error.

    FetchArtist(artistId string) (responseTypes.Artist, error)

    FetchArtist fetches information about an artist from Spotify's private API. It takes an artistId parameter, which is the Spotify ID of the artist. It returns an Artist object and an error.

    FetchAlbum(albumId string) (responseTypes.Album, error)

    FetchAlbum fetches information about an album from Spotify's private API. It takes an albumId parameter, which is the Spotify ID of the album. It returns an AlbumResponseType object and an error.

    Search(query string) (responseTypes.SearchResponseType, error)

    Search sends a GET request to Spotify's private API to search for tracks, albums, artists and playlists. It takes a query parameter, which is the search query. It returns a SearchResponseType object and an error.

    SearchTopResult(query string) (responseTypes.SearchTopResultResponseType, error)

    SearchTopResult first calls Search to get the search results, then it extracts the top results from the response. It takes a query parameter, which is the search query. It returns a SearchTopResultResponseType object and an error.

    Contributing

    Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

    License

    MIT

    Note: This package uses Spotify's private API and is not officially supported by Spotify. Use at your own risk.

    Full Changelog: https://github.com/FrostBreker/spotify-private-api/compare/v1.0.7...v1.0.8

    Downloads