Documentation for Yahoo! Shopping Web Services: User Product Review

Support & Community

The User Product Review service is discussed on the yws-shopping mailing list.

Request URL

http://api.shopping.yahoo.com/ShoppingService/V1/userproductreview

Request parameters

See information on constructing REST queries

Parameter	Value	Description
appid	string (required)	The application ID. See Application IDs for more information.
catalogid	integer (required)	The ID of the Yahoo! Shopping Buyers Guide catalog, as derived from a Catalog in a Product Search.
results	integer: default 10, max 100	The number of reviews to return.
sort	mostRecommended_descending (default) , mostRecommended_ascending, latest_descending, latest_ascending, highestRated_descending, highestRated_ascending	sorts reviews based on any of three criteria (ascending or descending order): most recommended latest highest rated
start	integer : default 1	The starting result position to return.

Sample Request Url: http://api.shopping.yahoo.com/ShoppingService/v1/userproductreview?catalogid=1991368668&appid=YahooDemo&results=5

Response fields

The schema document for this service response is located at http://api.shopping.yahoo.com/ShoppingService/v1/userproductreview.xsd

Field	Description
ResultSet	Contains all of the query responses. Has attributes: totalReviewsAvailable: The number of reviews available in the database. firstReviewPosition: The position of the first review.
Review	Contains each individual review.
Title	The title of the review as entered by the reviewer.
Reviewer	The name or Yahoo! ID that the reviewer chose to call them self.
CreateTime	The date the review was submitted, in unix timestamp format.To understand this format, see wikipedia-Unix Time.
HelpfulRecommendations	The number of people who found this review helpful.
TotalRecommendations	The total number of people who read this review.
OverallRating	The rating given by the reviewer for the product, out of 5.
Pro	The pros (positive attributes) of the product as per the reviewer.
Con	The cons (negative attributes) of the product as per the reviewer.
Posting	The body of the review.

Sample response

The following is a sample response for the query 1991368668, the product ID for the iPod Mini-Silver MP3 Player:

<?xml version="1.0"?>

<ResultSet xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="urn:yahoo:prodrev" xsi:schemaLocation="urn:yahoo:prodrev http://api.shopping.yahoo.com/shoppingservice/v1/userproductreview.xsd" totalReviewsAvailable="104" firstReviewPosition="1">

  <Review>

    <Title>Smaller package, good value...</Title>

    <Reviewer>lucky714x</Reviewer>

    <CreateTime>1082968807</CreateTime>

    <HelpfulRecommendations>62</HelpfulRecommendations>

    <TotalRecommendations>69</TotalRecommendations>



    <OverallRating>5</OverallRating>

    <Pro>Great form factor, feels great, reliable</Pro>

    <Con>none</Con>

    <Posting>Yeah yeah yeah, I've heard all the comments about how "expensive" this unit is. Not so! I compared it to the Rio Nitrus etc etc and there

's just more bang for the buck with the  MINI. I own the 20 gig (WHITE) iPod which I like a lot, but quite honestly, I love the form factor of the MINI. It

feels light but not cheap and a great display screen. 4 gigs you say, that's all? That's about 80 CD's. I figured that was enough for my girlfriend so she c

an use it to work out and still have plenty of choices. In comparison to the larger capacity iPods, it all depends what you're after. My best recommendation

 is to acually head to an Apple Store or whatever and try it out. Don't go on the written reviews alone.</Posting>

  </Review>

  <Review>

    <Title>iPod Mini = Overpriced</Title>



    <Reviewer>rulerofrabbits</Reviewer>

    <CreateTime>1078968320</CreateTime>

    <HelpfulRecommendations>92</HelpfulRecommendations>

    <TotalRecommendations>158</TotalRecommendations>

    <OverallRating>1</OverallRating>

    <Pro>Its small</Pro>



    <Con>Smaller hard drive for more money (compare to the old 4 gig)</Con>

    <Posting>When i heard that the iPod Mini come out I was amazed, shocked and totally in love.  I said to my self " i gota get me one of those!".  But as soon as i got home that night and saw the pricing, I was disgusted.  Being the owner of the "Old school" 5, 10 and 20 gigabite iPods and a proud ownerof a new 40 gigabite iPod, i was just disgusted with the price for the iPod mini. At the time. <br><br>Reasons why i hate it so much:<br>\

<br>1. It runs around 40 dollars less then the Modern 15 gigabite iPod (11 gigabites less)<br>2. The iPod mini holds about 100-300 less songs then the Old school 5 gigabite and 800 songs less then the modern 15 gigabite iPod which is now 40 dollars more then the mini.<br>3. They seem to be ch\

rging you for the color.</Posting>

  </Review>



  <Review>

    <Title>read this before buying anything BUT the mini</Title>

    <Reviewer>bhsnbacommissioner</Reviewer>

    <CreateTime>1083018377</CreateTime>

    <HelpfulRecommendations>17</HelpfulRecommendations>

    <TotalRecommendations>19</TotalRecommendations>



    <OverallRating>5</OverallRating>

    <Pro>more features, more user friendly</Pro>

    <Con>price</Con>

   <Posting>This is the best mp3 player out.  Although popel think it may be expensive it isnt since the quality of music apple offers is great!  Its\

 not only an audio player but it also has games,u can put news weather, notes , calenders and even contacts.  It's is definitely worth its cost.  I have had

 it since feburary 25 and Ive seen others, none of them even compare to the ipod mini.  The scrolling is heat sensitive which is really cool.  It never skip s and it is really easy to create a playlist while on the go since apple makes it so easy to search for songs.  <br><br><br>Get this IPOD MINI !!!!!!!!</Posting>

  </Review>

  <Review>

    <Title>iPod Mini The Pocket Player</Title>



    <Reviewer>modenaspiderman</Reviewer>

    <CreateTime>1092153498</CreateTime>

    <HelpfulRecommendations>10</HelpfulRecommendations>

    <TotalRecommendations>11</TotalRecommendations>

    <OverallRating>5</OverallRating>

    <Pro>This mini can fit in small places and can still hold plenty of music.  it has  very ergonomic  controls, so good they are makin iPod remixs with regular iPod size but with mini controls.</Pro>



    <Con>Like all iPods you have to have the right version of iTunes to download songs onto the iPod and you have to pay big bucks for  a new battery (&99) once the rechargeable one has worn out.</Con>

    <Posting>Excellent except for the battery and new itunes version thing.</Posting>

  </Review>

</ResultSet>

Additional Terms of Service

When calling the shopping APIs, you must set the HTTP user agent to a valid web browser string. Bot and spider strings are not valid. The user agent can be set to some default value - it does not have to be changed based on the user's browser. Some examples are as follows:

Mozilla/4.0 (compatible; MSIE 6.0; Windows NT 5.1) (for IE)
Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.0.1) Gecko/20060111 Firefox/1.5.0.1 (for FireFox)

More information on user agents can be found at http://en.wikipedia.org/wiki/user_agent.

For all Web sites and applications that present data from the Yahoo! Shopping API, the attribution text "Powered by Yahoo! Shopping" must also be presented.

Rate Limit

The User Product Review service is a part of the Yahoo! Shopping Web Services, which are limited to 5,000 queries per appid per day. See information on rate limiting.

Errors

The User Product Review service returns the standard errors. A 999 error is returned if the query limit has been exceeded.