LOG INtrack.searchByName
Description:
Searches tracks by title. The search may be refined by artistCode, to retrieve tracks by a specific artist and genreCode to retrieve tracks filed under a specific genre.
Authentication : NOT REQUIRED
Parameters:
apikey : application developer identifier [R]
country : catalogue country
format : output format
order: sorting field (
sort: sorting direction (
query : words to search for within track title [R].
artistCode : artist identifier
genreCode : genre code for filtering on genre
page : result page number
step : number of elements to retrieve
useSuggestion : flag to ask for suggestions (
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)query : words to search for within track title [R].
artistCode : artist identifier
genreCode : genre code for filtering on genre
page : result page number
step : number of elements to retrieve
useSuggestion : flag to ask for suggestions (
0 | 1). Set to 1 to get suggestions.
Return values:
List of tracks matching the title
available : number of tracks matching the title
page : index of current page (1 - based)
Sample call
http://api.playme.com/track.searchByName?query=sun&page=2&step=2&country=us&useSuggestion=1
Sample Result: XML
<?xml version="1.0" encoding="UTF-8"?> <response> <tracks> <track> <trackCode>3421777</trackCode> <name><![CDATA[Ain't No Sunshine]]></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[1]]></fullStream> <duration>253</duration> <publicationYear>2009</publicationYear> <artist> <artistCode>1081</artistCode> <name><![CDATA[Michael Jackson]]></name> </artist> <album> <albumCode>3421776</albumCode> <name><![CDATA[Hello World - The Motown Solo Collection]]></name> </album> <images> <img_256><![CDATA[image_url]]></img_256> <img_96><![CDATA[image_url]]></img_96> <img_64><![CDATA[http://images_site_url/cspv/image_name]]></img_64> <img_32><![CDATA[image_url]]></img_32> </images> <genre> <genreCode>80</genreCode> <name><![CDATA[R&B/Soul]]></name> </genre> </track> <track> <trackCode>1290378</trackCode> <name><![CDATA[You Got Another Thing Coming (sung by Jo LeSte)]]></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>290</duration> <publicationYear>2006</publicationYear> <artist> <artistCode>2005</artistCode> <name><![CDATA[Various Artists]]></name> </artist> <album> <albumCode>1290376</albumCode> <name><![CDATA[An Industrial Rock Tribute to Judas Priest]]></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>373</genreCode> <name><![CDATA[Hip-Hop/Rap]]></name> </genre> </track> <available>1000</available> <page>2</page> </tracks> <suggestions> <tracks> <track> <trackCode>4089060</trackCode> <name><![CDATA[Daddy's Gonna Tell You No Lie (45 Version)]]></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> <duration>183</duration> <publicationYear>2009</publicationYear> <artist> <artistCode>84116</artistCode> <name><![CDATA[Sun Ra]]></name> </artist> <album> <albumCode>4089059</albumCode> <name><![CDATA[Interplanetary Melodies]]></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>4089060</trackCode> <name><![CDATA[Daddy's Gonna Tell You No Lie (45 Version)]]></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> <duration>183</duration> <publicationYear>2009</publicationYear> <artist> <artistCode>84116</artistCode> <name><![CDATA[Sun Ra]]></name> </artist> <album> <albumCode>4089059</albumCode> <name><![CDATA[Interplanetary Melodies]]></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> </tracks> </suggestions> </response>
Sample Result: JSON
{
"response": {
"tracks": [{
"trackCode": "3770172",
"name": "Darkside Of The Sun",
"url": track_page_url,
"downloadUrl": download_url,
"previewUrl": preview_url,
"embeddedPlayer" : Play.me player HTML object code,
"duration": "232",
"publicationYear": "2009",
"artist": {
"artistCode": "2612",
"name": "Tokio Hotel"
},
"album": {
"albumCode": "3770170",
"name": "Humanoid"
},
"images": {
"img_256": image_url,
"img_96": image_url,
"img_64": image_url,
"img_32": image_url
},
"genre": {
"genreCode": "251",
"name": "Pop"
}
},
{
"trackCode": "3033745",
"name": "Sun Is Shining",
"url": track_page_url,
"downloadUrl": download_url,
"previewUrl": preview_url,
"embeddedPlayer" : Play.me player HTML object code,
"duration": "138",
"publicationYear": "2009",
"artist": {
"artistCode": "237",
"name": "Bob Marley"
},
"album": {
"albumCode": "3033743",
"name": "Lee \"Scratch\" Perry Masters"
},
"images": {
"img_256": image_url,
"img_96": image_url,
"img_64": image_url,
"img_32": image_url
},
"genre": {
"genreCode": "968",
"name": "Reggae"
}
}],
"available": "1000",
"page": "1",
"suggestions": {
"tracks": [{
"trackCode": "4089060",
"name": "Daddy's Gonna Tell You No Lie (45 Version)",
"url": track_page_url,
"downloadUrl": download_url,
"previewUrl": preview_url,
"embeddedPlayer" : Play.me player HTML object code,
"duration": "183",
"publicationYear": "2009",
"artist": {
"artistCode": "84116",
"name": "Sun Ra"
},
"album": {
"albumCode": "4089059",
"name": "Interplanetary Melodies"
},
"images": {
"img_256": image_url,
"img_96": image_url,
"img_64": image_url,
"img_32": image_url
},
"genre": {
"genreCode": "253",
"name": "Rock"
}
},
{
"trackCode": "4089060",
"name": "Daddy's Gonna Tell You No Lie (45 Version)",
"url": track_page_url,
"downloadUrl": download_url,
"previewUrl": preview_url,
"embeddedPlayer" : Play.me player HTML object code,
"duration": "183",
"publicationYear": "2009",
"artist": {
"artistCode": "84116",
"name": "Sun Ra"
},
"album": {
"albumCode": "4089059",
"name": "Interplanetary Melodies"
},
"images": {
"img_256": image_url,
"img_96": image_url,
"img_64": image_url,
"img_32": image_url
},
"genre": {
"genreCode": "253",
"name": "Rock"
}
},
{
"trackCode": "4089060",
"name": "Daddy's Gonna Tell You No Lie (45 Version)",
"url": track_page_url,
"downloadUrl": download_url,
"previewUrl": preview_url,
"embeddedPlayer" : Play.me player HTML object code,
"duration": "183",
"publicationYear": "2009",
"artist": {
"artistCode": "84116",
"name": "Sun Ra"
},
"album": {
"albumCode": "4089059",
"name": "Interplanetary Melodies"
},
"images": {
"img_256": image_url,
"img_96": image_url,
"img_64": image_url,
"img_32": image_url
},
"genre": {
"genreCode": "253",
"name": "Rock"
}
}
}]
}
}
}