Audio Song Search Documentation for Yahoo! Search Web Services

Support & Community

The Song Search service is discussed on the yws-search-general mailing list.

Request URL

http://search.yahooapis.com/AudioSearchService/V1/songSearch

Request parameters

See information on constructing REST queries

Parameter	Value	Description
appid	string (required)	The application ID. See Application IDs for more information.
artist	string	The artist or partial artist string to search for (UTF-8 encoded).
artistid	string	The specific id for an artist. Ids are internal to the Music Search Service and will be returned with artist references.
album	string	The album name or partial album string to search for (UTF-8 encoded).
albumid	string	The specific id for an album. Ids are internal to the Music Search Service and will be returned with album references.
song	string	The song title or partial song title string to search for (UTF-8 encoded).
songid	string	The specific id for a song. Ids are internal to the Music Search Service and will be returned with song references. At least one of artist, artistid, album, albumid, song or songid is required.
type	all (default), any, or phrase	The kind of search to submit: all returns results with all query terms. any returns results with one or more of the query terms. phrase returns results containing the query terms as a phrase.
results	integer: default 10, max 50	The number of results to return.
start	integer: default 1	The starting result position to return (1-based). The finishing position (start + results - 1) cannot exceed 1000.
output	string: xml (default), json, php	The format for the output. If json is requested, the results will be returned in JSON format. If php is requested, the results will be returned in Serialized PHP format.
callback	string	The name of the callback function to wrap around the JSON data. The following characters are allowed: A-Z a-z 0-9 . [] and _. If output=json has not been requested, this parameter has no effect. More information on the callback can be found in the Yahoo! Developer Network JSON Documentation.

Sample Request Url: http://search.yahooapis.com/AudioSearchService/V1/songSearch?appid=YahooDemo&albumid=XXXXXXR000012208&results=2

Response fields

The schema document for this service response is located at http://search.yahooapis.com/AudioSearchService/V1/SongSearchResponse.xsd

Field	Description
ResultSet	Contains all of the query responses. Has attributes: totalResultsAvailable: The number of query matches in the database. totalResultsReturned: The number of query matches returned. This may be lower than the number of results requested if there were fewer total results available. firstResultPosition: The position of the first result in the overall search.
Result	Contains each individual response. Has an attribute: id: The id associated with the song specified in this result.
Title	The title of the album.
Album	The album from which the song was taken (and associated id).
Artist	The performer of the song (and associated id).
Publisher	The publisher of the song.
Length	The length of the song in seconds
ReleaseDate	The date of the song's release.
Thumbnail	The URL of a thumbnail picture of the album cover the song was on and its height and width in pixels, if available.

Sample response

The following is a sample response for the albumid XXXXXXR000012208 (Madonna, Like a Prayer)

<?xml version="1.0" encoding="UTF-8"?>
<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:srchma" xsi:schemaLocation="urn:yahoo:srchmm http://search.yahooapis.com/AudioSearchService/V1/SongSearchResponse.xsd" totalResultsAvailable="11" totalResultsReturned="2" firstResultPosition="1">
	<Result id="XXXXXXT002734751">
		<Title>Like a Prayer</Title>
		<Album id="XXXXXXR000012208">Like a Prayer</Album>
		<Artist id="XXXXXXP000064565">Madonna</Artist>
		<Publisher>Sire</Publisher>
		<Length>339</Length>
		<ReleaseDate>1989</ReleaseDate>
		<Track>1</Track>
		<Thumbnail>
			<Url>http://thm-sorbet.search.vip.scd.yahoo.com/image/1900130944</Url>
			<Height>59</Height>
			<Width>60</Width>
		</Thumbnail>
	</Result>
	<Result id="XXXXXXT002734752">
		<Title>Express Yourself</Title>
		<Album id="XXXXXXR000012208">Like a Prayer</Album>
		<Artist id="XXXXXXP000064565">Madonna</Artist>
		<Publisher>Sire</Publisher>
		<Length>277</Length>
		<ReleaseDate>1989</ReleaseDate>
		<Track>2</Track>
		<Thumbnail>
			<Url>http://thm-sorbet.search.vip.scd.yahoo.com/image/1900130944</Url>
			<Height>59</Height>
			<Width>60</Width>
		</Thumbnail>
	</Result>
</ResultSet>

Rate Limit

The Song Search service is limited to 5,000 queries per IP address per day. See information on rate limiting and our Usage Policy to learn about acceptable uses and how to request additional queries.

Errors

The Song Search service returns the standard errors. There are no service-specific errors.