humm
humm is a ready-made, open, and fully catalogued “white label” index of online music, offered to developers through our ground-breaking API. humm enables developers to create their own innovative — and 100% legal — music solutions, and businesses to build music into their services. In a word, we aim to be the Android of Music Services.
humm endpoints
| Method | Endpoint | Description |
|---|---|---|
| Artists | ||
| GET |
Popular Artists /artists/popular |
Get a list of artists popular on Humm; returns a list of artist objects |
| GET |
Search Artists /artists |
Search for an artist; returns a list of artist objects |
| GET |
Recent Artists /artists/recent |
Get a list of artists recently added on Humm; returns a list of artist objects |
| GET |
Featured Artists /artists/featured |
Get a list of artists featured by Humm; returns a list of artist objects |
| GET |
Artist: Top Songs /artists/{id}/topsongs |
Get a list of an artist's top songs; returns a list of song objects for a given artist id |
| GET |
Artist: Playlists / Albums /artists/{id}/playlists |
Get playlists / albums associated with an artist; returns a list of playlist / album objects for a given id |
| GET |
Artist: Details /artists/{id} |
Get an artist; returns artist object for a given id |
| POST |
Artist: Follower (Add) /artists/{id}/followers |
Add current user to an artist's list of followers; returns artist object for a given id |
| GET |
Artist: Similar /artists/{id}/similar |
Get a list of musically similar artists; returns a list of artist objects for a given id |
| DELETE |
Artist: Follower (Remove) /artists/{id}/followers |
Remove current user from an artist's list of followers; returns artist object for a given id |
| GET |
Artist: Radio /artists/{id}/radio |
Get a curated list of artist songs; returns a list of song objects for a given artist id |
| Users | ||
| DELETE |
Follows (Remove User) /users/{id}/follows |
Remove user from the list current user follows; returns a user object |
| GET |
User: Details /users/{id} |
Get a user; returns a user object for a given id |
| GET |
User: Playlists /users/{id}/playlists |
Get a list of user owned playlists; returns list of playlist objects for given user id |
| GET |
Discover Artists /users/me/discover/artists |
Get a list of recommended artists; returns a list of artist objects |
| GET |
Discover Album Releases /users/me/discover/releases |
Get a list of recommended albums; returns a list of album objects |
| GET |
Discover Playlists / Albums /users/me/discover/playlists |
Get a list of recommended playlists / albums; returns a list of playlist / album objects |
| POST |
Follows (Add User) /users/{id}/follows |
Add user to the list current user follows; returns a user object |
| GET |
Current User /users/me |
Get the current user; returns a user object |
| GET |
User: Follows /users/{id}/follows |
Get a list of the users a user is following; returns a list of user objects for a given id |
| POST |
Favourites (Add) /songs/{id}/favourites |
Add song to current user favourites; returns a song object |
| Songs | ||
| GET |
Search Songs /songs |
Search for a song; returns a list of song objects |
| GET |
Popular Songs /songs/popular |
Get a list of songs popular on Humm; returns a list of song objects |
| GET |
Featured Songs /songs/featured |
Get a llist of songs featured by Humm; returns a list of song objects |
| GET |
Song: Similar /songs/{id}/similar |
Get a list of similar songs; returns a list of song objects for a given id |
| GET |
Song: Details /songs/{id} |
Get a song; returns song object for given id |
| GET |
Recent Songs /songs/recent |
Get a list of songs recently added on Humm; returns a list of song objects |
| GET |
Song: Appears In /songs/{id}/appearsin |
Get a list of playlists a song appears in; returns a list of playlist objects for a given id |
| Playlists / Albums | ||
| GET |
Popular Playlists /playlists/popular |
Get a list of playlists popular on Humm; returns a list of playlist objects (for an optional selection or user id) |
| GET |
Search Playlists / Albums /playlists |
Search Playlists / Albums; returns a list of playlist / album objects |
| GET |
Featured Playlists /playlists/featured |
Get a list of playlists featured by Humm; returns a list of playlist objects |
| GET |
Recent Playlists /playlists/recent |
Get a list of playlists recently added on Humm; returns a list of playlist objects |
| POST |
Create Playlist /playlists |
Add a playlist for the current user; returns a playlist object |
| GET |
Playlist: Songs /playlists/{id}/songs |
Get a list of playlist songs; return a list of song objects for a given id |
| POST |
Playlist: Songs (Add) /playlists/{id}/songs |
Add a song to a playlist given their ids |
| PATCH |
Playlist: Reorder Songs /playlists/{id}/reorder |
Reorder the songs in a playlist; returns a playlist object for a given id |
| DELETE |
Playlist: Songs (Remove) /playlists/{id}/songs |
Remove a song from a playlist for a given id |
| POST |
Playlist: Subscribers (Add) /playlists/{id}/subscribers |
Add playlist to the list current user has subscriptions to for a given id |
| GET |
Playlist: Details /playlists/{id} |
Get a playlist; returns playlist object for a given id |
| PATCH |
Playlist: Edit /playlists/{id} |
Edit a playlist; returns a playlist object for a given id |
| DELETE |
Playlist: Subscribers (Remove) /playlists/{id}/subscribers |
Remove playlist from the list current user has subscriptions to for a given id |
| Others | ||
| GET |
Radio /radio |
Get a list of songs for a radio; returns a list of song objects (*Must pass in one optional parameter e.g. 'rock') |
humm pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | — |
|