Welcome, guest Sign In

Music Song Download Location Documentation for Yahoo! Search

Submitting Queries to Retrieve URL of Audio files

The Song Download Location service allows you to find places to download individual songs, from the web, and from various online music sources. See also the other Audio Search services.

Request URL

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

Request parameters

See information on constructing REST queries

Parameter Value Description
appid string (required) The application ID. See Application IDs for more information.
songid string (required) The specific id for a song. Ids are internal to the Music Search Service and will be returned with song references.
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.
source string The source of the download. You may specify multiple values and a file from any of the sources specified will be returned. Valid values are:

  • audiolunchbox
  • artistdirect
  • buymusic
  • dmusic
  • emusic
  • epitonic
  • garageband
  • itunes
  • yahoo
  • livedownloads
  • mp34u
  • msn
  • musicmatch
  • mapster
  • passalong
  • rhapsody
  • soundclick
  • theweb
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://api.search..yahoo.com/AudioSearchService/V1/songDownloadLocation?appid=YahooDemo&songid=XXXXXXT002734752&results=2

Response fields

The schema document for this service response is located at http://search.yahooapis.com/AudioSearchService/V1/SongDownloadLocationResponse.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.
Source The source provider for the file.
Url The url for accessing the file.
Format The format the file has been encoded in.
Price The price, in dollars, of the song.
Length The length of the song in seconds.
Channels The number of channels. Usually 1 (mono) or 2 (stereo).
Restrictions

A space-separated list of restrictions and requirements:

  • drm denotes files with some form of digital rights management.
  • subrequired means a subscription to the appropriate service is required.
  • subnotrequired means a subscription to the appropriate service is not required.
  • win denotes files that will play on Windows.
  • mac denotes files that will play on Apple Macintoshes.
  • copyokay means this file may be copied.
  • copynotokay means this file may not be copied.
  • cdokay means this file may be burned to CD.
Quality A quality metric for files found on the web. Values range from 1 (worst) to 5 (best).

Sample response

The following is a sample response for the songid XXXXXXT002734752 (Madonna, Express Yourself)


Rate Limits

The Song Download Location service is limited to 5,000 queries per IP address per day and to noncommercial use. See information on rate limiting.

Terms of Use

Please see our Usage Policy to learn about acceptable uses and how to request additional queries.

Errors

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

Support & Community

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

Ready to get started?

By applying for an Application ID for this service, you hereby agree to the Terms of Use

YDN LIBRARIES & BEST PRACTICES

YAHOO! APIs & WEB SERVICES

LANGUAGE CENTERS

Copyright © 2008 Yahoo! Inc. All rights reserved. Copyright | Privacy Policy

Help us continue to improve the Yahoo! Developer Network - Send Your Suggestions