Url | http://musicovery.com/api/V5/search.php |
parameter | possible values | required/optional | comments |
---|---|---|---|
fct | search | required | code error 300 if missing |
q | required | ||
artist | [true false] default true | optional | include artists in the answer |
track | [true false] default true | optional | include tracks in the answer |
tag | [true false] default true | optional | include tags in the answer |
location | [true false] default true | optional | include locations in the answer |
partnerid | String | optional | required if the catalogid is specified |
catalogid | String | optional | |
resultsnumber | default 50 | optional | the number of results returned |
format | [xml-json] default xml | optional | the format of the response |
Url | http://musicovery.com/api/V5/track.php |
parameter | possible values | required/optional | comments |
---|---|---|---|
fct | search | required | code error 300 if missing |
title | hey joe | required | track title (song title) |
artistname | Jimi | optional | the name of the artist/band |
apikey | not required up to 200 requests | ||
minmatch | [0-100] default 30 | optional | the minimum relevance required (string very similar = close to 100) |
partnerid | String | optional | required if the catalogid is specified |
catalogid | String | optional | |
resultsnumber | default 50 | optional | the number of results returned |
bucket | id:foreignservice | optional | to get the results with ids of the following foreignservice=isrc, musicbrainz, spotify, deezer, sevendigital, lyricfind, itunes, amazonmp3, xboxmusic, qobuz, fnac, infoconcert, francebillet, digitick |
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track ID |
track foreign id | isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track title | track title |
track subtitle | track subtitle |
track work | track work |
track genre | track main genre |
track releasedate | year of release |
track album | album title |
track match | relevance of the track returned versus the track submitted |
Url | http://musicovery.com/api/V5/track.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getinfo | required | code error 300 if missing |
trackid | required | Musicovery track id, code error 320 if missing | |
id | foreignservice:track:xxxx ex: deezer:track:5196440 | optional | foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
listenercountry | us, uk, fr, it, es, ge, it no, wd | optional | 2 character international code |
bucket | id:foreignservice, ex: id:musicbrainz | optional | to get the results with ids of the following foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track ID |
track title | track title |
track foreign id | isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track subtitle | track subtitle |
track work | track work |
track artist name | artist name |
track artist mbid | artist Musicbrainz id |
track genre | track main genre |
track releasedate | year of release |
track album | album |
track popularity | measured on the scale 1-100 (100=very popular) |
track valence | position of the track on the dark/positive scale; integer 1 to 1 000 000; ex.127 239 (API key required) |
track arousal | the level of energy of the track; integer 1 to 1 000 000; ex.553 247 (API key required) |
track sampleurl | url to play the sample (API key required) |
Url | http://musicovery.com/api/V5/track.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getsimilar | required | code error 300 if missing |
id | foreignservice:track:xxxx ex: deezer:track:5196440 | Required(if partnertrackid not specific) | foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
partnertrackid | optional | Own track id of the partner | |
resultsnumber | default 20 limit 100 | optional | |
listenercountry | us, uk, fr, it, es, de, no, wddx_add_vars Default wd | optional | country as a 2 digit country code |
popularitymax | [0-100] | optional | 100=hit, 0=discovery |
popularitymin | [0-100] | optional | 100=hit, 0=discovery |
similaritytype | [0-100] default 60 | optional | if seed track is genre punk and danceable, 0 will return punk tracks, 100 will return danceable tracks |
limitgenre | Boolean default false | optional | limit the genre of similar tracks to the seed track's genre |
partnerid | optional | ||
catalogid | optional | ||
bucket | id:foreignservice, ex: id:musicbrainz | optional | to get the results with ids of the following foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true - false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track ID |
track foreign id | isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track title | track title |
track subtitle | track subtitle |
track work | track work |
track artist name | artist name |
track artist mbid | artist Musicbrainz id |
track genre | track genre |
track distance | 1 to 100 (0= very similar; 100 = little similar) |
track coverimg | url to display cover art (api key required) |
track sampleurl | url to the sample (api key required) |
Url | http://musicovery.com/api/V5/track.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | get_similar_by_audio | required | code error 300 if missing |
id | foreignservice:track:xxxx ex: deezer:track:5196440 | Required(if partnertrackid not specific) | foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
partnertrackid | optional | Own track id of the partner | |
resultsnumber | [1-500] default 20 | optional | |
partnertrackid | Required if seedaudiourl and youtubeurl empty | ||
seedaudiourl | Required if partnertrackid and youtubeurl empty | ||
youtubeurl | Required if partnertrackid and seedaudiourl empty | ||
partnerid | optional | ||
catalogid | optional | ||
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
partnertrackid | |
artist_name | |
track_title | |
distance | The similarity distance to the seed track (0 means identical, 1 very dissimilar) |
Url | http://musicovery.com/api/V5/artist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | search | required | code error 400 if missing |
artistname | required | the name of the artist/band, code error 410 if missing | |
bucket | id:foreignservice, ex: id:musicbrainz | optional | to get the results with ids of the following foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
minmatch | [0-100] default 30 | optional | the minimum relevance required (string very similar = close to 100) |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
artist mbid | artist Musicbrainz id |
artist foreign id | deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic, fnac, priceminister, soundcloud, Instagram |
artist name | artist name |
artist genre | |
artist country | country associated with the artist |
artist decade | decade when the artist started to be known |
artist match | match in %, 0 to 100 (100 = identical) |
Url | http://musicovery.com/api/V5/artist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getinfo | required | code error 400 if missing |
id | musicovery:artist:f467181e-d5e0-4285-b47e-e853dcc89ee7, or foreign ID foreignservice: | required | Musicovery artist ID or foreignservice ID:deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic, musicbrainz, fnac, priceminister, soundcloud, Instagram code error 320 if missing. |
bucket | id:foreignservice, ex: id:musicbrainz | optional | to get the results with ids of the following foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
artist mbid | artist Musicbrainz id |
artist foreign id | deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic, fnac, priceminister, soundcloud, Instagram |
artist name | artist name |
artist name2 | artist name2 |
artist genre | artist main genre |
artist genre2 | artist sub-genre |
role | vocalist, composer,... |
sexe | male/female |
decade_debut | decade when the artist started to be known |
year_debut | year when the artist started to be known |
artist match | match in %, 0 to 100 (100 = identical) |
continent | |
country | |
region | |
city |
Url | http://musicovery.com/api/V5/artist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getsimilar | required | code error 400 if missing |
id | foreignservice:artist:xxxx ex: musicovery:artist:f467181e-d5e0-4285-b47e-e853dcc89ee7 | required | Musicovery artist ID or foreign service ID:deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic, musicbrainz, fnac, priceminister, soundcloud, Instagram. In case of a group of several seed artists, use the coma between 2 artist ids (see example below). |
resultsnumber | default 20 limit 100 | optional | |
popularitymax | [0-100] | optional | 100=hit, 0=discovery |
popularitymin | [0-100] | optional | 100=hit, 0=discovery |
focusgenre | [true false] default false | optional | selects artists very similar in terms of genre |
focusera | [true false] default false | optional | selects artists from the same era |
obscureartists | [true false] default false | optional | selects similar artists with a popularity higher than 1/100 of the seed artist popularity |
bucket | id:foreignservice, ex: id:musicbrainz | optional | to get the results with ids of the following foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true - false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
artist mbid | artist Musicbrainz id |
artist foreign id | deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic, fnac, priceminister, soundcloud, Instagram |
artist name | artist name |
artist genre | artist main genre |
match | artist similarity 0 to 100 (100 = very similar) |
Url | http://musicovery.com/api/V5/artist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getfromlocation | required | code error 400 if missing |
bucket | id:foreignservice, ex: id:musicbrainz | optional | to get the results with ids of the following foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true - false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
location | required | code error 430 if missing | |
resultsnumber | default 20 limit 100 | optional | |
genreNo | rock, electro, pop, randb, hip hop, metal, classical, jazz, soundtrack, world, latin, reggae, folk, blues, country, vocal pop default empty | optional | genres banned separated by commas |
apikey | optional up to 500 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
artist mbid | artist Musicbrainz id |
artist foreign id | deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic, fnac, priceminister, soundcloud, Instagram |
artist name | artist name |
artist genre | artist main genre |
Url | http://musicovery.com/api/V5/artist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getusers | required | code error 400 if missing |
id | musicovery:artist:f467181e-d5e0-4285-b47e-e853dcc89ee7, or foreign ID foreignservice: | required | |
partnerid | String | optional | |
resultsnumber | default 20 limit 100 | optional | |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
users user userid | |
score |
Url | http://musicovery.com/api/V5/tag.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | search | required | code error 500 if missing |
tag | trip-hop, chillout, sad... | optional | the name of the tag |
type | [genre, mood, year, theme] | optional | the type of the tag |
language | [en, es, fr, de, it, pt, no] | optional | The language of the tag : ex. " variété " in French for " vocal pop " |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
tag name | tag name |
tag type | tag type |
tag language | tag language |
Url | http://musicovery.com/api/V5/tag.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getfromtime | required | code error 500 if missing |
dayoftheweek | Monday, Tuesday,... | optional | |
time | 00:00 | optional | |
listenercountry | us, uk, fr, it, es, de, no, wd Default wd | optional | |
language | en, es, fr, de, it, pt, no | optional | |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
tag name | tag name |
tag type | tag type |
tag language | tag language |
Url | http://musicovery.com/api/V5/location.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | search | required | code error 600 if missing |
scale | [continent, country, region, city] | optional | scale of the location (continent, country, region, city) |
location | optional | The location searched | |
apikey | optional up to 500 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
location scale | [continent, country, region, city] |
location name | location name |
Url | http://musicovery.com/api/V5/playlist.php |
Url | http://musicovery.com/api/V5/playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getfromtrack | required | code error 600 if missing |
id | 167394, foreignservice:track:xxxx, deezer:track:5196440 | required if partnertrack not specific | musicovery track id, code error 610 if missing |
partnertrackid | optional | Own track id of the partner | |
resultsnumber | [0-15] default 15 Premium API key [0-100] default 25 |
optional | The number of tracks requested in the playlist |
popularitymax | [0-100] 100=hit, 0=discovery, default 100 | optional | The maximum popularity of the tracks of the playlist on a scale 0-100 |
popularitymin | [0-100] 100=hit, 0=discovery default 25 | optional | The minimum popularity of the tracks of the playlist on a scale 0-100 |
similaritytype | [0-100] | optional | if seed track is genre punk and danceable, 0 will return punk tracks, 100 will return danceable tracks |
listenercountry | us, uk, fr, it, es, de, no, wd Default wd | optional | country of listener |
userid | String | optional | |
bucket | id:foreignservice, ex: id:musicbrainz | optional | to get the results with ids of the following foreignservice: isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true - false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
partnerid | String | optional | |
catalogid | String | optional | |
apikey | optional up to 500 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | musicovery track id |
track foreign id | isrc, musicbrainz, spotify, deezer, sevendigital, lyricfind, itunes, amazonmp3, xboxmusic, qobuz, fnac, infoconcert, francebillet, digitick |
track title | track title |
track subtitle | track work |
track artist mbid | artist MusicBrainz ID |
track artist name | artist name |
track genre | track main genre |
Url | http://musicovery.com/api/V5/playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getfromartist | required | code error 600 if missing |
id | foreignservice:artist:xxxx, musicbrainz:artist:a74b1b7f-71a5-4011-9441-d0b5e4122711 | required | artist Musicbrainz id, or foreign ID foreignservice: deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic, fnac, priceminister, soundcloud, Instagram |
resultsnumber | [0-15] default 15 Premium API key [0-100] default 25 |
optional | The number of tracks requested in the playlist |
popularitymax | [0-100] 100=hit, 0=discovery, default 100 | optional | The maximum popularity of the tracks of the playlist on a scale 0-100 |
popularitymin | [0-100] 100=hit, 0=discovery default 25 | optional | The minimum popularity of the tracks of the playlist on a scale 0-100 |
listenercountry | us, uk, fr, es, de, it, no, wd default wd | optional | country of listener |
focusgenre | Boolean default false | optional | selects artists very similar in terms of genre |
obscurartists | Boolean default false | optional | selects similar artists with a popularity higher than 1/100 of the seed artist popularity |
userid | String | optional | |
bucket | id:foreignservice, id:musicbrainz | optional | to get the results with ids of the following foreignservice=isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
partnerid | String | optional | |
catalogid | String | optional | |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | musicovery track id |
track foreign id | isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track title | |
track subtitle | |
track work | track work |
track artist mbid | artist MusicBrainz id |
track artist name | artist name |
track genre | track genre |
Url | http://musicovery.com/api/V5/playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getfromtag | required | code error 600 if missing |
tag | required | code error 630: if missing: The tag is optional if year parameters (yearmin or/and yearmax) are defined | |
resultsnumber | [0-15] default 15 Premium API key [0-100] default 25 |
optional | |
yearmax | optional | ||
yearmin | optional | yearmin must be < yearmax | |
popularitymax | [0-100] default 100 | optional | The maximum popularity of the tracks of the playlist on a scale 0-100, 100=hit, 0=discovery, default 100 |
popularitymin | [0-100] default 25 | optional | The minimum popularity of the tracks of the playlist on a scale 0-100, 100=hit, 0=discovery |
listenercountry | us, uk, fr, es, de, it, no, wd default wd | optional | 2 digits country code, country of the listener |
userid | String | optional | |
partnerid | String | optional | |
catalogid | String | optional | |
bucket | id:foreignservice, id:musicbrainz | optional | to get the results with ids of the following foreignservice=isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | musicovery track id |
track foreign id | isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track title | song/track title |
track subtitle | track subtitle |
track work | track work |
track artist mbid | |
track artist name | artist name |
track genre | track main genre |
Url | http://musicovery.com/api/V5/playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getfrommood | required | code error 600 if missing |
resultsnumber | [0-15] default 15 Premium API key [0-100] default 25 |
optional | number of tracks in the playlist |
trackvalence | [0-1000000] | required | |
trackarousal | [0-1000000] | required | |
yearmax | numeric default 2050 | optional | |
yearmin | numeric default 0 | optional | yearmin must be < yearmax |
before1950 | boolean default true | optional | |
date50 | boolean default true | optional | |
date60 | boolean default true | optional | |
date70 | boolean default true | optional | |
date80 | boolean default true | optional | |
date90 | boolean default true | optional | |
date00 | boolean default true | optional | |
date10 | boolean default true | optional | |
popularitymax | [0-100] default 20 | optional | The maximum popularity of the tracks of the playlist on a scale 0-100, 100=hit, 0=discovery, default 100 |
popularitymin | [0-100] default 25 | optional | The minimum popularity of the tracks of the playlist on a scale 0-100, 100=hit, 0=discovery | genreNo | rock, electro, pop, randb, hip hop, metal, classical, jazz, soundtrack, world, latin, reggae, folk, blues, country, vocal pop default empty | optional | genres banned for the playlist separated by commas |
listenercountry | us, uk, fr, es, de, it, no ,wd default: wddx_add_vars | optional | 2 digits country code, country of the listener |
tracksversions | Boolean default false | optional | Include a list of altternative versions for the tracks of the playlist |
trackstags | Boolean default false | optional | to get the tags associated with each track |
userid | String | optional | |
bucket | id:foreignservice, id:musicbrainz | optional | to get the results with ids of the following foreignservice=isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
partnerid | String | optional | |
catalogid | String | optional | |
apikey | not required up to 200 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track id |
track foreign id | isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track title | song/track title |
track subtitle | song/track subtitle |
track work | song/track work |
track artist mbid | MusicBrainz ID |
track artist name | artist name |
track genre | track main genre |
Url | http://musicovery.com/api/V5/playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getnewreleases | required | code error 600 if missing |
popularitymax | [0-100] 100=hit,0=discovery default: 100 | optional | |
popularitymin | [0-100] 100=hit,0=discovery default: 25 | ||
listenercountry | optional | ||
resultsnumber | [0-15] default 15 Premium API key [0-100] default 25 |
optional | number of tracks in the playlist |
genreNo | rock, electro, pop, randb, hip hop, metal, classical, jazz, soundtrack, world, latin, reggae, folk, blues, country, vocal pop default empty | optional | genres banned for the playlist separated by commas |
listenercountry | us, uk, fr, es, de, it, no, wd default: wd | optional | 2 digits country code, country of the listener |
userid | String | optional | |
bucket | id:foreignservice, id:musicbrainz | optional | to get the results with ids of the following foreignservice=isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
partnerid | String | optional | |
apikey | optional up to 500 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track id |
track foreign id | isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track title | song/track title |
track subtitle | song/track subtitle |
track work | song/track work |
track artist mbid | artist MusicBrainz ID |
track artist name | artist name |
track genre | track main genre |
Url | http://musicovery.com/api/V5/playlist.php |
Parameter | Possible values | Required/optional | Comment |
---|---|---|---|
fct | getfromlocation | required | code error 600 if missing |
location | String | required | |
listenercountry | optional | ||
resultsnumber | [0-15] default 15 Premium API key [0-100] default 25 |
optional | number of tracks in the playlist |
genreNo | rock, electro, pop, randb, hip hop, metal, classical, jazz, soundtrack, world, latin, reggae, folk, blues, country, vocal pop default empty | optional | genres banned for the playlist separated by commas : rock,electro,pop |
listenercountry | optional | 2 digits country code, country of the listener | |
bucket | id:foreignservice, id:musicbrainz | optional | to get the results with ids of the following foreignservice=isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
apikey | optional up to 500 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track id |
track foreign id | Musicovery isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track title | song/track title |
track subtitle | song/track title |
track work | song/track work |
track artist mbid | artist MusicBrainz ID |
track artist name | artist name |
track genre | track main genre |
track coverimg | url to display cover art (API key required) |
track sampleurl | url to play the sample (API key required) |
Url | http://musicovery.com/api/V5/playlist.php |
Parameter | Possible values | Required/optional | Comment |
---|---|---|---|
fct | getsmart | required | code error 600 if missing |
userid | required | ||
partnerid | required | code error 1020 if missing | |
bucket | optional | to get the results with ids of the following foreignservice=isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic | |
limittobucket | optional | limit results to objects available in the foreign id specified by &bucket= | |
resultsnumber | [0-15] default 15 Premium API key [0-100] default 25 |
optional | number of tracks in the playlist |
apikey | optional up to 500 requests | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track id |
track foreign id | Musicovery isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
track title | song/track title |
track subtitle | song/track title |
track work | song/track work |
track artist mbid | artist MusicBrainz ID |
track artist name | artist name |
track genre | track main genre |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | postinfo | required | code error 1000 if missing |
userid | alphanumerical | required | id of the user |
partnerid | alphanumerical | required | id of the partner posting the info about his user |
country | 2 letters country code: ex. it,fr,us | optional | country of the user |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | postsession | required | code error 1000 if missing |
sessionid | optional | if not specified the method returns a sessionid | |
userid | alphanumerical | required if ipaddress and terminalid not specified | id of the user |
partnerid | required | id of the partner posting the info about his user | |
ipaddress | optional | ||
terminalid | required if userid and ipaddress not specified | ||
lat | format 00.00 | optional | lattitude |
long | format 00.00 | optional | longitude |
sessiontime | date/Time 0000-00-00 00:00 | optional | date and time of the begining of the session (local time) |
devicetype | desktop, phone, tablet, car, watch, other | optional | |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio, postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | postpreference | required | code error 1000 if missing |
userid | alphanumerical | required | id of the user |
partnerid | required | id of the partner | |
partnertrackid | optional | Own track id of the partner | |
sessionid | alphanumerical | optional | |
objectid | 167394, deezer:track:5196440 | requiredif partnertrackid not specific | Musicovery track id, artist mbid, genre |
objecttype | [artist, track, genre] | required | |
objectstatus | [like, dislike, neutral] | required | |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
1040 | missing or invalid value for parameter: objectid |
1050 | missing or invalid value for parameter: objecttype accepted values : track, artist, genre |
1060 | missing or invalid value for parameter: objectstatus accepted values : like, dislike,neutral |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | postradio | required | code error 1000 if missing |
userid | alphanumerical | required | id of the user |
partnerid | required | id of the partner | |
sessionid | alphanumerical | optional | |
radiodid | optional | ||
radiotype | [artist, track, moodpad, genre, mood, theme, year, new] | required | a 'moodpad' radio is generated from mood coordinates (valence, arousal); a 'mood' radio is generated from a word (ex.: 'sensual'). |
radioobject | MusicBrainz artist id, Musicovery track id, arousal/valence coordinates, genre name, theme name, the year as a number | required | - for an artist radio: &radioobject=artistmbid - for a moodpad radio: &radioobject=valence,arousal - for a track radio: &radioobject=trackid - for a genre radio: &radioobject=genre name - for a theme radio: &radioobject=theme name - for a year radio: &radioobject=year (as a number) - for a new release radio: null |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
1030 | missing or invalid value for parameter: sessionid |
1070 | missing or invalid value for parameter: radiotype accepted values : genre, artist, track, mood, year, moodpad, new |
1080 | missing or empty value for parameter: radioobject |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | postplay | required | code error 1000 if missing |
userid | alphanumerical | optional | id of the user |
partnerid | required | id of the partner | |
sessionid | alphanumerical | required | |
radioid | alphanumerical | optional | |
trackid | requiredif partnertrack not specific | Musicovery track id | |
partnertrackid | optional | Own track id of the partner | |
playtype | [entire, skipped, interrupted, removed] | required | |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
1030 | missing or invalid value for parameter: sessionid |
1090 | missing or empty value for parameter: trackid |
1095 | missing or invalid value for parameter: playtype accepted values : entire, skipped, removed, interruped |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getlastradios | required | code error 1000 if missing |
userid | alphanumerical | required | id of the user |
partnerid | required | id of the partner | |
resultsnumber | [0-20] default 5 | optional | number of results per object (artists,track,tag) |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getrecommendations | required | code error 1000 if missing |
userid | alphanumerical | required | id of the user |
partnerid | alphanumerical | required | id of the partner |
catalogid | alphanumerical | optional | To restrict recommendation of tracks to a specific catalog |
resultsnumber | [0-20] default 5 | optional | |
allfavorites | [true - false] default false | optional | calculate recommendations using all favorite songs (=true), or a selection (=false) |
update | >Boolean default false | optional | &update=true recalculates the profile, otherwise returns the last value. |
bucket | id:foreignservice, id:musicbrainz | optional | to get the results with ids of the following foreign service=isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
limittobucket | [true false] default false | optional | limit results to objects available in the foreign id specified by &bucket= |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Data | description |
---|---|
tracks recommended tracks | Musicovery track id for track 1, track 2... |
track foreign ids | isrc, musicbrainz, deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic |
Burnt tracks | missing or invalid value for parameter: userid |
artists recommended artists | Musicbrainz id of artist 1, artist 2,... |
artist foreign ids | deezer, spotify, sevendigital, itunes, qobuz, amazonmp3, xboxmusic, fnac, priceminister, soundcloud, Instagram |
Burnt artist | |
Recommended genres | genre 1, genre 2,... |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getnewalbums | required | code error 1000 if missing |
userid | alphanumerical | required | id of the user |
partnerid | alphanumerical | required | Id of the partner getting recommendations for his user |
resultsnumber | default: 5 limit: 20 | required | Id of the partner getting recommendations for his user |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Description |
---|---|
album title 1 | |
album title 2 | |
album title 3 |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getprofile | required | code error 1000 if missing |
userid | alphanumerical | required | id of the user |
partnerid | alphanumerical | required | id of the partner |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Data | Comment |
---|---|
user profile | curious, fan, mainstream, average |
user curiosity indice | 1 (not curious) -10 (very curious) |
user diversity indice | 1 (focus on 1 genre) -10 (diverse genres) |
user skip rate | 0.000 to 1.000 |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
Url | http://musicovery.com/api/V5/user.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | delete | required | code error 1000 if missing |
userid | alphanumerical | required | id of the user |
partnerid | alphanumerical | required | id of the partner |
apikey | required | ||
format | [xml-json] default xml | optional | the format of the response |
Code | Comment |
---|---|
100 | valid |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postuserpreference, postradio,postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
Url | http://musicovery.com/api/V5/catalog.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | post | required | code error 1000 if missing |
partnerid | alphanumerical | required | id of the partner |
catalogid | alphanumerical | optional | if not specified the method returns a catalogid |
apikey | required | API key level 2 required | |
format | [xml-json] default xml | optional | the format of the response |
Data | Comment |
---|---|
Message | OK/error_log |
catalogid | catalogid (generated by Musicovery if null in the request) |
Url | http://musicovery.com/api/V5/catalog.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | delete | required | code error 1200 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
catalogid | alphanumerical | optional | code error 1205 if missing |
apikey | required | API key level 2 required | |
format | [xml-json] default xml | optional | the format of the response |
Data | Comment |
---|---|
Message | OK/error_log |
catalogid | catalogid (generated by Musicovery if null in the request) |
Url | http://musicovery.com/api/V5/catalog.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | list | required | code error 1000 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
catalogid | alphanumerical | required | code error 1205 if missing |
bucket | id:musicbrainz, id:foreignservice | optional | |
apikey | required | API key level 2 required | |
format | [xml-json] default xml | optional | the format of the response |
Data | Comment |
---|---|
partner_track_id | Partner track id |
musicovery_track_id | musicovery track id |
foreign_track_id | foreign service track id |
Url | http://musicovery.com/api/V5/catalog.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | post_track | required | code error 1000 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
catalogid | alphanumerical | required | code error 1205 if missing |
title | required | ||
artistname | required | ||
partnertrackid | required | ||
albumname | optional | ||
audio_url | optional | If the audio file of the track is to be indexed, this parameter is required | |
isrc | optional | ||
tag | optional | ||
apikey | required | API key level 2 required | |
format | [xml-json] default xml | optional | the format of the response |
Data | Comment |
---|---|
Musicovery track id | Musicovery track id if the track was matched |
match | match score |
foreign_track_id | foreign service track id |
Url | http://musicovery.com/api/V5/catalog.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | delete_track | required | code error 1000 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
catalogid | alphanumerical | required | code error 1205 if missing |
partnertrackid | required | ||
apikey | required | API key level 2 required | |
format | [xml-json] default xml | optional | the format of the response |
Code | Description |
---|---|
100 | valid |
101 | invalid apikey: contact B2B@musicovery.com |
102 | 1 s. interval for 2 requests reached |
103 | too many requests |
104 | apikey expired: contact B2B@musicovery.com |
105 | missing parameter: apikey, you need a valid apikey |
106 | invalid apikey for the partnerid value |
107 | invalid apikey for the partnerid value |
300 | missing or invalid value for parameter: fct accepted values: search, getinfo, getsimilar |
310 | missing or empty parameter: title |
320 | missing or empty parameter: id |
400 | missing or invalid value for parameter: fct accepted values: search, getsimilar, getfromlocation |
410 | missing or empty parameter: artistname |
420 | missing or empty parameter: artistmbid |
430 | missing or empty parameter: location |
500 | missing or invalid value for parameter: fct accepted values: search |
600 | missing or invalid value for parameter: fct accepted values: getfromtrack, getfromartist, getfromtag, getfrommood, getnewreleases, getfromlocation |
610 | missing or empty parameter: id |
615 | This track is not in Musicovery’s database. |
620 | missing or empty parameter: artistmbid |
630 | missing or empty parameter: tag |
640 | missing or empty parameter: location |
700 | missing or invalid value for parameter: q |
800 | missing or invalid value for parameter: userid |
900 | missing or invalid value for parameter: fct accepted values: search |
910 | at least one of this parameters : location, scale has to be not null |
1000 | missing or invalid value for parameter: fct accepted values: postinfo, postsession, postpreference, postradio, postplay, getlastradios, getrecommendations, getprofile, delete |
1010 | missing or invalid value for parameter: userid |
1020 | missing or invalid value for parameter: partnerid |
1025 | no user found in the DB for userid/partnerid |
1028 | session allready defined for the userid/partnerid |
1030 | missing or invalid value for parameter: sessionid |
1040 | missing or invalid value for parameter: objectid |
1050 | missing or invalid value for parameter: objecttype accepted values : track, artist, genre |
1060 | missing or invalid value for parameter: objectstatus accepted values : like, dislike,neutral |
1070 | missing or invalid value for parameter: radiotype accepted values : genre, artist, track, tag, mood, year, theme, genre, actvity, moodpad, new |
1080 | missing or empty value for parameter: radioobject |
1090 | missing or empty value for parameter: trackid |
1095 | missing or invalid value for parameter: playtype accepted values : entire, skipped, removed, interruped |
Version | Release date | Reatures |
---|---|---|
5.0 | 03.03.2017 | addition of tthe methods: artists.getusers, user.getAlbums |
4.0 | 12.03.2017 | addition of catalog methods, method playlist.getsmart and tag.getFromTime, artist.getsimilar with several seed artists. |
3.0 | 15.10.2015 | addition of user, location methods and moodpad playlists |
2.0 | 20.03.2015 | addition of user, location methods and moodpad playlists |
1.0 | 23.01.2014 | release of the initial version with playlist and recommendations |
Musicovery API v1 documentation available here |
Musicovery API v2 documentation available here |
Musicovery API v3 documentation available here |