Table of Contents
/item/{ymid}/{type}?appid=...&id=...&machineID=...&incremental=...&format=...&callback=...
GET
Returns a user's ratings for one or more types of media.
Requires BBAuth for authentication
Example: http://us.music.yahooapis.com/rating/v1/item/4501956/artist?appid=[yourapplicationidhere]
Responses: “Rating List Response (application/xml - ym:Ratings)”
Required Parameters
| Parameter | Value | Description |
|---|---|---|
| ymid | long | Yahoo! Music User ID |
| type | One of: artist / release / track / video / category /
playlist
|
The type of rating being given. |
| appid | string | YDN Application ID. See Application IDs for more information. |
Optional Parameters
| Parameter | Value | Default / Possible values | Description |
|---|---|---|---|
| id | string | Comma-separated list of item IDs to return ratings for (depends on type). If none are passed, returns all ratings for the given type (except playlist). To get all playlist ratings, see machineID and incremental description. | |
| machineId | string | GUID of the machine ID for receiving incremental updates | |
| incremental | int |
|
Requires machineID. |
| callback | string | If output is json, wraps the result in the
specified callback function. |
|
| format | string |
|
Format of the result. |
/item/{ymid}/{type}?appid=...&
POST
Returns a user's ratings for one or more types of media.
Requires BBAuth for authentication
Request: “Rating Request Post XML (application/xml - ym:Ratings)”
Responses: None
Required Parameters
| Parameter | Value | Description |
|---|---|---|
| ymid | long | Yahoo! Music User ID |
| type | One of: artist / release / track / video / category / playlist | The type of rating. |
| appid | string | YDN Application ID. See Application IDs for more information. |
Optional Parameters
| Field | Description | Attributes |
|---|---|---|
| Ratings | List of Ratings |
|
| Rating | Rating for an item. POST data must contain one or more. |
|