Project description
python-hearthis
Unofficial Python client for hearthis.io API https://hearthis.at/api-v2/
Dependencies
- Requests - package required for making requests
Quick Start
import hearthis
kwargs = {
"email": "foo@bar.com",
"password": "foobar"
}
heart = hearthis.Hearthis(**kwargs)
Available APIs
# returns hearthis user feed
response = heart.feed()
Parameter |
Value |
Default |
Description |
page |
int |
1 |
page to how |
count |
int |
5 |
entries per page (max: 20) |
duration |
int |
- |
duration (+/- 5 minutes) |
type |
str |
- |
[empty] / popular / new |
category |
str |
- |
[empty] / house / drumandbass / etc. - see genre API |
show_feed_start |
str |
2019-04-10 |
Start Date |
show_feed_end |
str |
2019-04-17 |
End Date |
response = heart.all_genres()
response = heart.genre_list()
Parameter |
Value |
Default |
Description |
genre |
str |
- |
Genre from All Genres API |
page |
int |
1 |
page to how |
count |
int |
5 |
entries per page (max: 20) |
duration |
int |
- |
duration (+/- 5 minutes) |
response = heart.artist()
- Single Artist Follow/Unfollow
response = heart.artist_follow_unfollow()
Parameter |
Value |
Default |
Description |
artist_id |
int |
- |
ID of artist |
response = heart.artist_list()
Parameter |
Value |
Default |
Description |
artist |
str |
1 |
Artist username |
type |
str |
["tracks", "user", "playlists"] |
|
page |
int |
1 |
page to how |
count |
int |
5 |
entries per page (max: 20) |
response = heart.track()
Parameter |
Value |
Default |
Description |
track_uri |
str |
- |
Track URI |
response = heart.track_like_unlike()
Parameter |
Value |
Default |
Description |
track_id |
int |
- |
ID of track |
response = heart.add_playlist()
Parameter |
Value |
Default |
Description |
name |
str |
- |
Name of track |
track_id |
int |
- |
ID of track (optional) |
- Add Existing playlist track
response = heart.add_playlist_track()
Parameter |
Value |
Default |
Description |
playlist_id |
int |
- |
ID of playlist |
track_id |
int |
- |
ID of track |
- Delete Track and Playlist
response = heart.delete_playlist()
Parameter |
Value |
Default |
Description |
playlist_id |
int |
- |
ID of playlist |
track_id |
int |
- |
ID of track (optional) |
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution