Url | http://musicovery.com/api/V6/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 json | optional | the format of the response |
Url | http://musicovery.com/api/V6/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 |
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track ID |
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/V6/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 | |
listenercountry | us, uk, fr, it, es, ge, it no, wd | optional | 2 character international code |
apikey | not required up to 200 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track ID |
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 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/V6/track.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getsimilar | required | code error 300 if missing |
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 | ||
apikey | not required up to 200 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track ID |
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/V6/track.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | get_similar_by_audio | required | code error 300 if missing |
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 json | 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/V6/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 | |
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 json | optional | the format of the response |
Data | Description |
---|---|
artist mbid | artist Musicbrainz id |
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/V6/artist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getinfo | required | code error 400 if missing |
id | musicovery:artist:f467181e-d5e0-4285-b47e-e853dcc89ee7 | required | Musicovery artist ID code error 320 if missing. |
apikey | not required up to 200 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
artist mbid | artist Musicbrainz id |
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/V6/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. 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 |
apikey | not required up to 200 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
artist mbid | artist Musicbrainz id |
artist name | artist name |
artist genre | artist main genre |
match | artist similarity 0 to 100 (100 = very similar) |
Url | http://musicovery.com/api/V6/artist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getfromlocation | required | code error 400 if missing |
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 json | optional | the format of the response |
Data | Description |
---|---|
artist mbid | artist Musicbrainz id |
artist name | artist name |
artist genre | artist main genre |
Url | http://musicovery.com/api/V6/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 json | optional | the format of the response |
Data | Description |
---|---|
users user userid | |
score |
Url | http://musicovery.com/api/V6/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 json | 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/V6/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 json | 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/V6/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 json | optional | the format of the response |
Data | Description |
---|---|
location scale | [continent, country, region, city] |
location name | location name |
Url | http://musicovery.com/api/V6/playlist.php |
Url | http://musicovery.com/api/V6/playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getfromtrack | required | code error 600 if missing |
id | 167394 | 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 | |
partnerid | String | optional | |
catalogid | String | optional | |
apikey | optional up to 500 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | musicovery track id |
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/V6/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 |
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 | |
partnerid | String | optional | |
catalogid | String | optional | |
apikey | not required up to 200 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | musicovery track id |
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/V6/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 | |
apikey | not required up to 200 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | musicovery track id |
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/V6/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 | |
partnerid | String | optional | |
catalogid | String | optional | |
apikey | not required up to 200 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track id |
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/V6/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 | |
partnerid | String | optional | |
apikey | optional up to 500 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track id |
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/V6/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 | |
apikey | optional up to 500 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track id |
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/V6/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 | |
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 json | optional | the format of the response |
Data | Description |
---|---|
track id | Musicovery track id |
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/V6/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 json | 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/V6/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 json | 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/V6/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 |
apikey | required | API key level 2 required | |
format | [xml-json] default json | 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/V6/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 json | 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/V6/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 json | optional | the format of the response |
Data | Comment |
---|---|
Mrssage | Error/log |
Url | http://musicovery.com/api/V6/editorial_playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | post | required | code error 1000 if missing |
partnerid | alphanumerical | required | id of the partner |
playlist_id | alphanumerical | optional | |
playlist_name | alphanumerical | optional | |
playlist_url | alphanumerical | optional | |
playlist_img_url | alphanumerical | optional | |
apikey | required | API key level 2 required | |
format | [xml-json] default json | optional | the format of the response |
Data | Comment |
---|---|
Message | OK/error_log |
playlist_id | playlist_id (generated by Musicovery if null in the request) |
Url | http://musicovery.com/api/V6/editorial_playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | delete | required | code error 1200 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
playlist_id | alphanumerical | required | code error 1205 if missing |
apikey | required | API key level 2 required | |
format | [xml-json] default json | optional | the format of the response |
Data | Comment |
---|---|
Message | OK/error_log |
Url | http://musicovery.com/api/V6/editorial_playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | list | required | code error 1000 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
apikey | required | API key level 2 required | |
format | [xml-json] default json | optional | the format of the response |
Data | Comment | playlist_id | id of the playlist | playlist_name | name of the playlist | playlist_url/td> | url of the playlist | playlist_img_url/td> | image associated to the playlist |
---|
Url | http://musicovery.com/api/V6/editorial_playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | post_track | required | code error 1000 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
playlist_id | alphanumerical | required | code error 1205 if missing |
title | required | ||
artistname | required | ||
partnertrackid | required | ||
albumname | optional | ||
isrc | optional | ||
apikey | required | API key level 2 required | |
format | [xml-json] default json | optional | the format of the response |
Data | Comment |
---|---|
track_id | track_id (generated by Musicovery if null in the request) |
Url | http://musicovery.com/api/V6/editorial_playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | delete_track | required | code error 1000 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
playlist_id | alphanumerical | required | code error 1205 if missing |
partnertrackid | required | ||
apikey | required | API key level 2 required | |
format | [xml-json] default json | optional | the format of the response |
Url | http://musicovery.com/api/V6/editorial_playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | tracks_list | required | code error 1000 if missing |
partnerid | alphanumerical | required | code error 1020 if missing |
playlist_id | alphanumerical | required | code error 1205 if missing |
apikey | required | API key level 2 required | |
format | [xml-json] default json | optional | the format of the response |
Data | Comment |
---|---|
message | Ok/Error Log |
Url | http://musicovery.com/api/V6/editorial_playlist.php |
Parameter | Possible values | Required/optional | Comments |
---|---|---|---|
fct | getsimilar | required | code error 400 if missing |
playlist_id | required | ||
apikey | not required up to 200 requests | ||
format | [xml-json] default json | optional | the format of the response |
Data | Description |
---|---|
playlist_id | id of the playlist |
playlist_name | name of the playlist |
playlist_url | url of the playlist |
playlist_img_url | image associated to the playlist |
match | playlist similarity (0 - 100 |
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 | Features |
---|---|---|
6.0 | 10.01.2019 | addition of the group of methods editorial playlists, and the method get similar tracks by audio. |
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 |
Musicovery API v3 documentation available here |
Musicovery API v3 documentation available here |