album-of-the-year-api 0.2.1

A light weight Python library that acts as an API for the website albumoftheyear.org

AlbumOfTheYearWrapper

A light weight python library that acts as an API for https://www.albumoftheyear.org/

Description

Gets data from https://www.albumoftheyear.org/. The website doesn't currently provide API support so web parsing is required to obtain data. Because of this, according to https://www.albumoftheyear.org/robots.txt, searching and POST requests are not allowed.

Installation

Usage

</code></pre>
<p>or upgrade</p>
<pre lang="pip"><code>

Examples

Here's a quick example of getting a specific users follower count

client = AOTY()
print_num_of_followers('doublez')

def print_num_of_followers(user):
    print(client.user_followers(user))

If you don't need the full functionality, you can also import only the neccesary files

client = ArtistMethods
print_all_artist_albums('183-kanye-west')

def print_all_artist_albums(artist):
    print(client.artist_albums(artist))

Notice artists also need their unique id along with their name

Artist Methods

artist_albums(artist)
Returns all albums by an artist
Parameters:

• artist - artist id and name

artist_mixtapes(artist)
Returns all mixtapes by an artist
Parameters:

• artist - artist id and name

artist_eps(artist)
Returns all eps by an artist
Parameters:

• artist - artist id and name

User Methods

user_ratings(user)
Returns the number of ratings by a user
Parameters:

• user - username

user_reviews(user)
Returns the number of reviews by a user
Parameters:

• user - username

user_lists(user)
Returns the number of lists by a user
Parameters:

• user - username

user_followers(user)
Returns the number of followers a user has
Parameters:

• user - username

user_about(user)
Returns the about page of a user
Parameters:

• user - username

user_rating_distribution(user)
Returns a list of a users rating distribution
Parameters:

• user - username