track.searchByArtist
Description:
Searches tracks by artist's name.
Note that the API searches for matches of the provided artist's name within the Dada catalogue: this means that searching artist's name buckley you may expect to retrieve tracks both by Tim Buckley and Jeff Buckley.
To retrieve tracks of a specific artist, consider to use artist.getTracks api.
Authentication : NOT REQUIRED
Parameters:
apikey : application developer identifier [R]
country : catalogue country
format : output format
order: sorting field (
sort: sorting direction (
page : result page
step : number of tracks to retrieve
query : artist's name to search for [R]
country : catalogue country
format : output format
order: sorting field (
album_name | artist_name | track_name). If not provided, results are sorted by matching relevance in descending order.sort: sorting direction (
asc | desc)page : result page
step : number of tracks to retrieve
query : artist's name to search for [R]
Return values:
List of track entities
Sample call
http://api.playme.com/track.searchByArtist?query=david bowie&step=2&page=2
Sample Result: XML
<?xml version="1.0" encoding="UTF-8"?> <response> <tracks> <track> <trackCode>50678</trackCode> <name><![CDATA[Oh! You Pretty Things]]></name> <url><![CDATA[track_page_url]]></url> <downloadUrl><![CDATA[download_url]]></downloadUrl> <previewUrl><![CDATA[preview_url]]></previewUrl> <embeddedPlayer><![CDATA[Play.me player HTML object code]]></embeddedPlayer> <fullStream><![CDATA[0]]></fullStream> <duration></duration> <publicationYear></publicationYear> <artist> <artistCode>421</artistCode> <name><![CDATA[David Bowie]]></name> </artist> <album> <albumCode></albumCode> <name><![CDATA[]]> </name> </album> <images> <img_256><![CDATA[image_url]]></img_256> <img_96><![CDATA[image_url]]></img_96> <img_64><![CDATA[image_url]]></img_64> <img_32><![CDATA[image_url]]></img_32> </images> <genre> <genreCode>253</genreCode> <name><![CDATA[Rock]]></name> </genre> </track> <track> <trackCode>50677</trackCode> <name><![CDATA[Let's Spend The Night Together]]></name> <url><![CDATA[http://contents_site_url/track_page]]></url> <downloadUrl><![CDATA[http://download_site_url]]></downloadUrl> <previewUrl><![CDATA[http://preview_site_url]]></previewUrl> <embeddedPlayer><![CDATA[Play.me player HTML object code]]></embeddedPlayer> <fullStream><![CDATA[0]]></fullStream> <duration></duration> <publicationYear></publicationYear> <artist> <artistCode>421</artistCode> <name><![CDATA[David Bowie]]></name> </artist> <album> <albumCode></albumCode> <name><![CDATA[]]> </name> </album> <images> <img_256><![CDATA[image_url]]></img_256> <img_96><![CDATA[image_url]]></img_96> <img_64><![CDATA[image_url]]></img_64> <img_32><![CDATA[image_url]]></img_32> </images> <genre> <genreCode>253</genreCode> <name><![CDATA[Rock]]></name> </genre> </track> <available>1000</available> <page>2</page> </tracks> </response>
Sample Result: JSON
{
"response": {
"tracks": [{
"trackCode": "50678",
"name": "Oh! You Pretty Things",
"url": "track_page_url",
"downloadUrl": "download_url/",
"previewUrl": "preview_url",
"embeddedPlayer" : Play.me player HTML object code,
"fullStream": "0",
"duration": "",
"publicationYear": "",
"artist": {
"artistCode": "421",
"name": "David Bowie"
},
"album": {
"albumCode": "",
"name": ""
},
"images": {
"img_256": "image_url",
"img_96": "image_url",
"img_64": "image_url",
"img_32": "image_url"
},
"genre": {
"genreCode": "253",
"name": "Rock"
}
},
{
"trackCode": "50677",
"name": "Let's Spend The Night Together",
"url": "track_page_url",
"downloadUrl": "download_url/",
"previewUrl": "preview_url",
"embeddedPlayer" : Play.me player HTML object code,
"fullStream": "0",
"duration": "",
"publicationYear": "",
"artist": {
"artistCode": "421",
"name": "David Bowie"
},
"album": {
"albumCode": "",
"name": ""
},
"images": {
"img_256": "image_url",
"img_96": "image_url",
"img_64": "image_url",
"img_32": "image_url"
},
"genre": {
"genreCode": "253",
"name": "Rock"
}
}],
"available": "1000",
"page": "2"
}
}
LOG IN