MusicLynx API

This is MusicLynx API, a backend for the MusicLynx music discovery platform. It connects to native data stores and remote services that make links between music artists including MusicBrainz, Dbpedia, Wikidata, LastFM, AcousticBrainz, and others. The following modules are accessible: Audio, Artist, Dbpedia, MusicBrainz, MusicLynx, and Sameas.

The base URI for the API: http://musiclynx-api.herokuapp.com

Artist

Get Featured Artists: /get_featured_artists
Example: http://musiclynx-api.herokuapp.com/artist/get_featured_artists

Get Artist By MusicBrainz ID: /get_mb_artist/:mbid/:name
Example: http://musiclynx-api.herokuapp.com/artist/get_mb_artist/1dcc8968-f2cd-441c-beda-6270f70f2863/Hole

Get Artist By Dbpedia URI (base-64 encoded): /get_mb_artist/:dbpedia_uri/:name
Example: http://musiclynx-api.herokuapp.com/artist/get_dbp_artist/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL1BpeGllcw==/Pixies

Get AcousticBrainz Similar Artists By Rhythm, Tonality and Timbre: /get_acousticbrainz_artists/:mbid
Example: http://musiclynx-api.herokuapp.com/artist/get_acousticbrainz_artists/410c9baf-5469-44f6-9852-826524b80c61

Get Moodplay Similar Artists: /get_moodplay_artists/:mbid
Example: http://musiclynx-api.herokuapp.com/artist/get_moodplay_artists/702d2b90-eef0-4354-b2c4-6366eba92b7f

Get Similar Artist Graph: /get_artist_graph/:dbpedia_uri/:name/:id/:limit/:filter/:degree
where :dbpedia_uri is the base-64 encoded Dbpedia URI, :id is MusicBrainz ID, :limit is maximum number of artists in the graph, :filter is one of jaccard (1), collaborative (2), sorensen (3), maximum degree weighted (default, 4), heat spreading (5), and :degree is number of categories to which the artist belongs
Example: http://musiclynx-api.herokuapp.com/artist/get_artist_graph/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL1BpeGllcw==/Pixies/b6b2bb8d-54a9-491f-9607-7b546023b433/47/4/9

Audio

Get Deezer ID: /get_deezer_id/:term
Example: http://musiclynx-api.herokuapp.com/audio/get_deezer_id/Santigold

Get Deezer Playlist: /get_deezer_playlist/:term
Example: http://musiclynx-api.herokuapp.com/audio/get_deezer_playlist/Merzbow

Dbpedia

Get Associated Artists By Dbpedia URI (base-64 encoded): /get_associated_artists/:dbpedia_uri
Example: http://musiclynx-api.herokuapp.com/dbpedia/get_associated_artists/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL0ZlbGFfS3V0aQ==

Get Categories By Dbpedia URI (base-64 encoded): /get_categories/:dbpedia_uri
Example: http://musiclynx-api.herokuapp.com/dbpedia/get_categories/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL01pcmlhbV9NYWtlYmE=

Construct Artist By Dbpedia URI (base-64 encoded): /construct_artist/:dbpedia_uri
Example: http://musiclynx-api.herokuapp.com/dbpedia/construct_artist/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL0ZhdG91bWF0YV9EaWF3YXJh

Get All Linked Artists By Dbpedia URI (base-64 encoded): /get_all_linked_artists/:dbpedia_uri
Example: http://musiclynx-api.herokuapp.com/dbpedia/get_all_linked_artists/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL0ZlbGFfS3V0aQ==

Get Category Degrees By Dbpedia URI (base-64 encoded): /get_category_degrees/:dbpedia_uri
Example: http://musiclynx-api.herokuapp.com/dbpedia/get_category_degrees/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL1BKX0hhcnZleQ==

Get Artist Redirect By Dbpedia URI (base-64 encoded): /get_artist_redirect/:dbpedia_uri
Example: http://musiclynx-api.herokuapp.com/dbpedia/get_artist_redirect/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL1cuQS5fTW96YXJ0

MusicBrainz

Search Artists: /artist_search/:searchTerm
Example: http://musiclynx-api.herokuapp.com/musicbrainz/artist_search/Ellen%20Allien

MusicLynx

Link MusicBrainz ID to Dbpedia URI: /link_mb_id/:id
Example: http://musiclynx-api.herokuapp.com/musiclynx/link_mb_id/96003ca6-5c03-4771-8b94-dbdc74949125/Angel%20Haze

Link Dbpedia URI to MusicBrainz ID: /link_dbp_uri/:dbpedia_uri
Example: http://musiclynx-api.herokuapp.com/musiclynx/link_dbp_uri/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL0FuZ2VsX0hhemU=/Angel%20Haze

Musixmatch

Search Artists: /get_similar_artists/:id/:name
Example: http://musiclynx-api.herokuapp.com/musixmatch/get_similar_artists/07b6020a-c539-4d68-aeef-f159f3befc76/Band%20Of%20Horses

Sameas

Find Dbpedia URI By MusicBrainz ID and Name: /find_dbpedia_link/:mbid/:name
Example: http://musiclynx-api.herokuapp.com/sameas/find_dbpedia_link/97b20fe3-0924-4a5f-9955-d0b5c5f9587f/Santigold

Find MusicBrainz ID by Dbpedia URI and Name: /find_dbpedia_link/:artist_uri/:name
Example: http://musiclynx-api.herokuapp.com/sameas/find_musicbrainz_id/aHR0cDovL2RicGVkaWEub3JnL3Jlc291cmNlL1NpZ3VyX1LDs3M=/Sigur%20R%C3%B3s