eBay Shopping API897

FindReviewsAndGuides

This call searches reviews and guides based on product, category, or user. The response provides information about each user or product's reviews and guides.

Note: Reviews and Buying Guides are available in the Production Environment only. They are not available in the Sandbox.

Usage Details

Buying guides contain content about particular product areas, categories, or subjects to help buyers decide which type of item to purchase based on their particular interests. These guides are intended for buyers who do not already have a specific product in mind. For example, a digital camera buying guide could help a buyer determine what kind of digital camera is right for them.

For a list of buying guides that are currently available on the US site, see the Buying Guide hub.

For information about specifying affiliate parameters, see Affiliate URL Parameters and HTTP Header Values.

Search queries may return URLs for multiple buying guides. Buying guides may be returned for a matching item's category as well as its parent and child categories. Information about each buying guide is returned in the same order that it would be displayed on the Web site. The guide for the current category (if any) is returned first. Then guides for its child categories are returned. Finally, guides for its parent categories are returned. When many buying guides are found, only URLs for the first few buying guides are returned. Use the URLs along with the buying guide names (also returned) to create links in your application to the buying guides.

You can retrieve buying guide details in the following manner:

Use FindProducts to find a product, then retrieve the product's reviews and guides using FindReviewsAndGuides and ProductID. Buying guide details are not necessarily returned for all searches, as some categories and products are not associated with buying guides.

When user searches for items in certain categories, the results may also include URLs for relevant buying guides.

To determine which eBay site URL the FindReviewsAndGuides response is most similar to, please refer to this chart. The following links are examples:

Query By

ReviewsAndGuidesURL

BuyingGuideDetails.BuyingGuide.URL

BuyingGuideDetails.BuyingGuideHub

ReviewDetails.Review.URL

UserID

User Summary Page

Single Guide URL

User Guides Page

User Reviews Page

CategoryID

Category Guides Page

Category Guides Page

N/A

ProductID

N/A

Product Title Search Guides Page

N/A

UserID+CategoryID

User Summary Page

User Category Guides Page

User Reviews Page

UserID+ProductID

N/A

Product Title Search Guides Page

N/A

Best Practices

To test your application's ability to correctly present functional buying guide links, you can begin by testing against the US production site. For example, you can search in these categories on the US site (to retrieve the latest category IDs, you can either search for an item using the Finding API or query GetCategoryInfo with the root category ID of -1):

Related Information

See also the reference documentation for these calls:



Back to top

Input

The box below lists all fields that could be included in the call request. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<FindReviewsAndGuidesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Input Fields -->
  <CategoryID> string </CategoryID>
  <MaxResultsPerPage> int </MaxResultsPerPage>
  <PageNumber> int </PageNumber>
  <ProductID type="ProductIDCodeType"> ProductIDType (string) </ProductID>
  <ReviewSort> ReviewSortCodeType </ReviewSort>
  <SortOrder> SortOrderCodeType </SortOrder>
  <UserID> string </UserID>
  <!-- Standard Input Fields -->
  <MessageID> string </MessageID>
</FindReviewsAndGuidesRequest>
Argument Type Occurrence Meaning
Call-specific Input Fields [Jump to standard fields]
CategoryID string Optional Specify a single CategoryID to restrict your query to a specific Guide category.

If the specified category ID doesn't match an existing category for the site, an invalid-category error message is returned. To determine valid categories:
Use findItemsAdvanced from the Finding API with CategoryHistogram value in the OutputSelector field to retrieve matching categories. Then make another FindReviewsAndGuides call with the ID of a matching category.

CategoryID can be used in combination with UserID to return Reviews and Guides. ProductID and CategoryID cannot be used together.
MaxResultsPerPage int Optional Specifies the maximum number of reviews per page (not guides) in the returned list. If not specified, the default returns 5 results per page.
Max: 20. Default: 5.
PageNumber int Optional Specifies the number of the page of data to return in the current call. Specify a positive value equal to or lower than the number of pages available (which you determine by examining the results of your initial request).
ProductID ProductIDType (string) Optional Use this to retrieve reviews (not guides) for one specific product. Specify the ID as a string, and use the type attribute to indicate the nature of the ID you are specifying. Same as FindProducts, supports Reference, ISBN, UPC, EAN.

ProductID can be used in combination with UserID to return Reviews and Guides. ProductID and CategoryID cannot be used together.
ProductID
  [ attribute type ]
ProductIDCodeType Conditional Use this to retrieve reviews (not guides) for one specific product. Specify the ID as a string, and use the type attribute to indicate the nature of the ID you are specifying. Same as FindProducts, supports Reference, ISBN, UPC, EAN.

ProductID can be used in combination with UserID to return Reviews and Guides. ProductID and CategoryID cannot be used together.

For a list of possible enumeration values, see ProductIDCodeType.
ReviewSort ReviewSortCodeType Optional Include ReviewSort in your request if you want to sort by a parameter, such as CreationTime. See the SortOrder field for values for specifying that results are returned in ascending or descending order. (By default, results are returned in descending order.)

Applicable values:

CreationTime
(in) Sorts reviews by creation time, in ascending or descending order.
CustomCode
(in) Reserved for values that are not available in the version of the schema you are using. If eBay adds a new value to this code type as of a newer version, we return CustomCode instead when you specify a lower request version.

SortOrder SortOrderCodeType Optional Sorts search results in ascending or descending order, in conjunction with the value you specify in ReviewsSort. The default is descending order.

For example, for the ReviewsSort value of CreationTime, and a SortOrder value of Descending, the most recently created reviews are returned first.
Default: Descending.

Applicable values:

Ascending
(in) Sorts results in ascending (low to high) order.
CustomCode
(in) Placeholder value. See token.
Descending
(in) Sorts results in descending (high to low) order.

UserID string Optional Retrieves reviews and guides written by the specified user.

UserID can be combined with either ProductID or CategoryID but not both (as ProductID and CategoryID cannot be used together).
Standard Input Fields  
MessageID string Optional If you pass a value in MessageID in a request, we'll return the same value in CorrelationID in the response. If you're making a lot of calls, you can use this for tracking that a response is returned for every request and to match particular responses to particular requests. (In this case, specify a different value for each request.) You can specify any value that is useful to you.



Back to top

Output

The box below lists all fields that might be returned in the response. To learn more about an individual field or its type, click its name in the box (or scroll down to find it in the table below the box).

See also Samples.

<?xml version="1.0" encoding="utf-8"?>
<FindReviewsAndGuidesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <!-- Call-specific Output Fields -->
  <BuyingGuideCount> int </BuyingGuideCount>
  <BuyingGuideDetails> BuyingGuideDetailsType
    <BuyingGuide> BuyingGuideType
      <CategoryID> string </CategoryID>
      <CreationTime> dateTime </CreationTime>
      <Name> string </Name>
      <Text> string </Text>
      <Title> string </Title>
      <URL> anyURI </URL>
      <UserID> string </UserID>
    </BuyingGuide>
    <!-- ... more BuyingGuide nodes allowed here ... -->
    <BuyingGuideHub> anyURI </BuyingGuideHub>
  </BuyingGuideDetails>
  <PageNumber> int </PageNumber>
  <PositiveHelpfulnessVotes> int </PositiveHelpfulnessVotes>
  <ProductID type="ProductIDCodeType"> ProductIDType (string) </ProductID>
  <ReviewCount> int </ReviewCount>
  <ReviewDetails> ReviewDetailsType
    <AverageRating> float </AverageRating>
    <Review> ReviewType
      <CreationTime> dateTime </CreationTime>
      <Rating> int </Rating>
      <Text> string </Text>
      <Title> string </Title>
      <URL> anyURI </URL>
      <UserID> string </UserID>
    </Review>
    <!-- ... more Review nodes allowed here ... -->
  </ReviewDetails>
  <ReviewerRank> int </ReviewerRank>
  <ReviewsAndGuidesURL> anyURI </ReviewsAndGuidesURL>
  <TotalHelpfulnessVotes> int </TotalHelpfulnessVotes>
  <TotalPages> int </TotalPages>
  <!-- Standard Output Fields -->
  <Ack> AckCodeType </Ack>
  <Build> string </Build>
  <CorrelationID> string </CorrelationID>
  <Errors> ErrorType
    <ErrorClassification> ErrorClassificationCodeType </ErrorClassification>
    <ErrorCode> token </ErrorCode>
    <ErrorParameters ParamID="string"> ErrorParameterType
      <Value> string </Value>
    </ErrorParameters>
    <!-- ... more ErrorParameters nodes allowed here ... -->
    <LongMessage> string </LongMessage>
    <SeverityCode> SeverityCodeType </SeverityCode>
    <ShortMessage> string </ShortMessage>
  </Errors>
  <!-- ... more Errors nodes allowed here ... -->
  <Timestamp> dateTime </Timestamp>
  <Version> string </Version>
</FindReviewsAndGuidesResponse>
Return Value Type Occurrence Meaning
Call-specific Output Fields [Jump to standard fields]
BuyingGuideCount int Always Number of returned buying guides.
BuyingGuideDetails BuyingGuideDetailsType Always Contains information for up to 5 buying guides that match the query. Buying guides provide useful information about shopping in a particular domain, like Digital Cameras. For example, a digital camera buying guide could help a buyer determine what kind of digital camera is right for them. If no buying guides are associated with the product, this only returns a link to the buying guide hub (the main Guides page). Count limited by MaxResultsPerPage in request.
BuyingGuideDetails.BuyingGuide BuyingGuideType Conditionally,
repeatable: [0..*]
Information that identifies a buying guide. A buying guide contains content about particular product areas, categories, or subjects to help buyers decide which type of item to purchase based on their particular interests. Buying guides are useful to buyers who do not have a specific product in mind. For example, a digital camera buying guide could help a buyer determine what kind of digital camera is right for them.
BuyingGuideDetails.BuyingGuide
  .CategoryID
string Conditionally Identifies the category (if any) that is associated with the buying guide. For FindReviewsAndGuides, this can be a category that is higher or lower in the hierarchy than the category specified in the request. For a matching categories search, you can use this information to determine the order that the buying guides are returned in when multiple guides are found. Optionally, you can use this information to determine where to present the buying guide link in your application.
Max length: 10.
BuyingGuideDetails.BuyingGuide
  .CreationTime
dateTime Conditionally The time and date when the guide was posted.
BuyingGuideDetails.BuyingGuide
  .Name
string Conditionally Display name of the buying guide.

FindReviewsAndGuides only returns 20 characters, followed by "..." if the name is longer than 20 characters. For the full title, see BuyingGuide.Title instead.
BuyingGuideDetails.BuyingGuide
  .Text
string Conditionally The text of the guide. If the guide is longer than 2000 characters, the text is cut off and it ends with "...". See BuyingGuide.URL for a link to the full text of the review.
Max length: 2000.
BuyingGuideDetails.BuyingGuide
  .Title
string Conditionally The title of the buying guide.
Max length: 55.
BuyingGuideDetails.BuyingGuide
  .URL
anyURI Conditionally URL for the buying guide. Your application can present this as a link. Use the value of Name or Title as the link's display name.
BuyingGuideDetails.BuyingGuide
  .UserID
string Conditionally The author's eBay user ID.
BuyingGuideDetails
  .BuyingGuideHub
anyURI Always URL of the buying guide home page for the site being searched. Your application can present this URL as a link. Optionally, you can use a value like "See all buying guides" as the link's display name.
PageNumber int Always The number of the page of data returned. If many products are found and multiple pages of results are available, use this in combination with TotalPages to decide which page to retrieve next. As FindProducts only returns up to 2000 products, the maximum possible value is theoretically 2000 (if you were to set MaxResultsPerPage to 1 in the request).
Min: 1. Max: 2000.
PositiveHelpfulnessVotes int Conditionally Number of helpfulness votes if using user search.
ProductID ProductIDType (string) Conditionally The eBay or external IDs associated with the product. Use the Reference value as input to search for the same product in the future, or use the ISBN, EAN, or UPC value (if returned). The ISBN, EAN, and UPC values can also be useful as keys if your application is comparing products across different sites. Always returned when Product is returned.
ProductID
  [ attribute type ]
ProductIDCodeType Always The eBay or external IDs associated with the product. Use the Reference value as input to search for the same product in the future, or use the ISBN, EAN, or UPC value (if returned). The ISBN, EAN, and UPC values can also be useful as keys if your application is comparing products across different sites. Always returned when Product is returned.

For a list of possible enumeration values, see ProductIDCodeType.
ReviewCount int Always Number of returned reviews.
ReviewDetails ReviewDetailsType Conditionally Contains information about review details. Count limited by MaxResultsPerPage in request.
ReviewDetails.AverageRating float Conditionally The product's average rating (out of 5) based on all reviews. For example, a value like 4.5 would mean the average rating is 4.5 out of 5. (See ReviewCount for the total number of reviews.)
Min: 0. Max: 5.
ReviewDetails.Review ReviewType Conditionally,
repeatable: [0..20]
An eBay member's review of the product.
ReviewDetails.Review
  .CreationTime
dateTime Conditionally The time and date when the reviewer posted the review.
ReviewDetails.Review.Rating int Conditionally The eBay member's rating of the product.
Min: 0. Max: 5.
ReviewDetails.Review.Text string Conditionally The text of the review. If the review is longer than 2000 characters, the text is cut off and it ends with "...". See Review.URL for a link to the full text of the review.
Max length: 2000.
ReviewDetails.Review.Title string Conditionally The title of the review.
Max length: 55.
ReviewDetails.Review.URL anyURI Conditionally A link to the full review on the eBay Web site. This URL optimized for natural search: "_W0QQ" is like "?" (question mark), "QQ" is like "&" (ampersand), and "Z" is like "=" (equals sign).

Note: For a link to all reviews for the product, remove the upvr parameter from this URL. See the eBay Features Guide for an example.
ReviewDetails.Review.UserID string Conditionally The reviewer's eBay user ID.
ReviewerRank int Conditionally Rank of reviewer if using user search.
ReviewsAndGuidesURL anyURI Always URL to the reviews and guides page.
TotalHelpfulnessVotes int Conditionally Number of helpfulness votes if using user search.
TotalPages int Always Indicates the total number of pages of data that could be returned by repeated requests. Returned with a value of 0 if no pages are available.
Standard Output Fields  
Ack AckCodeType Always Indicates whether the call was successfully processed by eBay.

Applicable values:

CustomCode
(out) Reserved for internal or future use.
Failure
(out) Request processing failed
Success
(out) Request processing succeeded
Warning
(out) Request processing completed with warning information being included in the response message

(Not all values in AckCodeType apply to this field.)
Build string Always This refers to the particular software build that eBay used when processing the request and generating the response. This includes the version number plus additional information. eBay Developer Support may request the build information when helping you resolve technical issues.
CorrelationID string Conditionally If you pass a value in MessageID in a request, we will return the same value in CorrelationID in the response. You can use this for tracking that a response is returned for every request and to match particular responses to particular requests. Only returned if MessageID was used.
Errors ErrorType Conditionally,
repeatable: [0..*]
A list of application-level errors or warnings (if any) that were raised when eBay processed the request.

Application-level errors occur due to problems with business-level data on the client side or on the eBay server side. For example, an error would occur if the request contains an invalid combination of fields, or it is missing a required field, or the value of the field is not recognized. An error could also occur if eBay encountered a problem in our internal business logic while processing the request.

Only returned if there were warnings or errors.
Errors.ErrorClassification ErrorClassificationCodeType Conditionally API errors are divided between two classes: system errors and request errors.

Applicable values:

CustomCode
(out) Reserved for internal or future use.
RequestError
(out) An error has occurred either as a result of a problem in the sending application or because the application's end-user has attempted to submit invalid data (or missing data). In these cases, do not retry the request. The problem must be corrected before the request can be made again. If the problem is due to something in the application (such as a missing required field), the application must be changed. If the problem is a result of end-user data, the application must alert the end-user to the problem and provide the means for the end-user to correct the data. Once the problem in the application or data is resolved, resend the request to eBay with the corrected data.
SystemError
(out) Indicates that an error has occurred on the eBay system side, such as a database or server down. An application can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.

See Errors by Number.

Errors.ErrorCode token Conditionally A unique code that identifies the particular error condition that occurred. Your application can use error codes as identifiers in your customized error-handling algorithms.

See Errors by Number.

Errors.ErrorParameters ErrorParameterType Conditionally,
repeatable: [0..*]
Some warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error. You can usually predict where these will occur by looking at the "replaceable_value" indicators in our Errors by Number page.

See Errors by Number.

Errors.ErrorParameters
  [ attribute ParamID ]
string Conditionally Some warning and error messages return one or more variables that contain contextual information about the error. This is often the field or value that triggered the error. You can usually predict where these will occur by looking at the "replaceable_value" indicators in our Errors by Number page.
Errors.ErrorParameters.Value string Conditionally The value of the variable.
Errors.LongMessage string Conditionally A more detailed description of the condition that raised the error.

See Errors by Number.

Errors.SeverityCode SeverityCodeType Conditionally Indicates whether the error caused the request to fail.

If the request fails and the source of the problem is within the application (such as a missing required element), please change the application before you retry the request. If the problem is due to end-user input data, please alert the end-user to the problem and provide the means for them to correct the data. Once the problem in the application or data is resolved, you can attempt to re-send the request to eBay.

If the source of the problem is on eBay's side, you can retry the request as-is a reasonable number of times (eBay recommends twice). If the error persists, contact Developer Technical Support. Once the problem has been resolved, the request may be resent in its original form.

When a warning occurs, the error is returned in addition to the business data. In this case, you do not need to retry the request (as the original request was successful). However, depending on the cause or nature of the warning, you might need to contact either the end user or eBay to effect a long term solution to the problem to prevent it from reoccurring in the future.

Applicable values:

CustomCode
(out) Reserved for internal or future use
Error
(out) The request that triggered the error was not processed successfully. When a serious application-level error occurs, the error is returned instead of the business data.
Warning
(out) The request was processed successfully, but something occurred that may affect your application or the user. For example, eBay may have changed a value the user sent in. In this case, eBay returns a normal, successful response and also returns the warning.

See:
    Errors by Number
    Checklist for Going Live for more information see the eBay Features Guide.

Errors.ShortMessage string Conditionally A brief description of the condition that raised the error.

See Errors by Number.

Timestamp dateTime Always This value represents the date and time when eBay processed the request. The time zone of this value is GMT and the format is the ISO 8601 date and time format (YYYY-MM-DDTHH:MM:SS.SSSZ). See the "dateTime" type for information about this time format and converting to and from the GMT time zone.
Version string Always The release version that eBay used to process the request.

Note: This is usually the latest release version, as specified in the release notes. (eBay releases the API to international sites about a week after we release it to the US site.)

If a field in the response returns the token "CustomCode", it usually means that the field is a code type (a token or enumeration), and that in your request URL (or HTTP header) you specified a version that is older than the version in which the token was added to the call.

See Schema Versioning Strategy.



Back to top

Detail Controls


DetailLevel

This call does not support varying Detail Levels. You do not need to pass DetailLevel in the request.

Back to top

Samples

New to making API calls? Please see Making an API Call.

Note: Some item IDs, user IDs, or other data in these samples might no longer be active on eBay. If necessary, you can substitute current eBay data in your requests.

Available samples:

Sample: Basic Call

Retrieves Reviews and Guides for the specified Category.

Input

This sample searches for Reviews and Guides associated with the Category you supply.

URL format (HTTP GET). See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.
http://open.api.ebay.com/shopping?
   callname=FindReviewsAndGuides&
   responseencoding=XML&
   appid=YourAppIDHere&
   siteid=0&
   version=531&
   CategoryID=29997

   Here is the same input in XML format (HTTP POST). Note that this does not include standard values.

XML format (HTTP POST). Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<FindReviewsAndGuidesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <CategoryID>29997</CategoryID>
</FindReviewsAndGuidesRequest>

Output

XML format.
<?xml version="1.0" encoding="UTF-8" ?> 
<FindReviewsAndGuidesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2007-09-13T00:43:01.640Z</Timestamp> 
  <Ack>Success</Ack> 
  <Build>e531_intl_APILW2_5315915_R1</Build> 
  <Version>531</Version> 
  <BuyingGuideCount>2</BuyingGuideCount> 
  <ReviewsAndGuidesURL>http://search.reviews.ebay.com/_Digital+Cameras_W0QQuqtZgQQucatZ29997</ReviewsAndGuidesURL> 
  <PageNumber>1</PageNumber> 
  <TotalPages>1</TotalPages> 
  <BuyingGuideDetails>
    <BuyingGuide>
      <Name>Digital Cameras</Name> 
      <URL>http://reviews.ebay.com/Digital-Cameras-Buying-Guide_W0QQugidZ10000000000057160</URL> 
      <CategoryID>29997</CategoryID> 
      <Title>Digital Cameras Buying Guide</Title> 
      <Text><html xmlns:xsd="http://www.w3.org/2001/XM...</Text> 
      <CreationTime>2005-09-29T21:54:11.000Z</CreationTime> 
    </BuyingGuide>
    <BuyingGuide>
      <Name>Buying Your First Di...</Name> 
      <URL>http://reviews.ebay.com/Buying-Your-First-Digital-SLR-Camera_W0QQugidZ10000000000000684</URL> 
      <CategoryID>43456</CategoryID> 
      <Title>Buying Your First Digital SLR Camera</Title> 
      <Text><h1>Buying Your First Digital SLR Camera<...</Text> 
      <CreationTime>2005-09-22T17:41:14.000Z</CreationTime> 
      <UserID>pjaya1</UserID> 
    </BuyingGuide>
    <BuyingGuideHub>http://search.reviews.ebay.com/_Digital-Cameras_W0QQucatZ29997QQuqtZg</BuyingGuideHub> 
  </BuyingGuideDetails>
</FindReviewsAndGuidesResponse>

Back to list of samples

Sample: Searching by ProductID

Retrieves a set of Reviews and Guides that pertain to the specified ProductID.

Input

This sample finds Reviews and Guides associated with a specified ProductID.

URL format (HTTP GET). See also the non-wrapped version of this URL. For results in a format other than XML, 
specify a different value for responseencoding.
http://open.api.ebay.com/shopping?
   callname=FindReviewsAndGuides&
   responseencoding=XML&
   appid=YourAppIDHere&
   siteid=0&
   version=531&
   ProductID.type=UPC&
   ProductID.value=085391698920

   Here is the same input in XML format (HTTP POST). Note that this does not include standard values.

XML format (HTTP POST). Also available is the .txt version of this XML.

<?xml version="1.0" encoding="utf-8"?>
<FindReviewsAndGuidesRequest xmlns="urn:ebay:apis:eBLBaseComponents">
  <ProductID type="UPC">085391698920</ProductID>
</FindReviewsAndGuidesRequest>

Output

XML format.
<?xml version="1.0" encoding="utf-8"?>
<FindReviewsAndGuidesResponse xmlns="urn:ebay:apis:eBLBaseComponents">
  <Timestamp>2007-09-17T22:14:11.453Z</Timestamp>
  <Ack>Success</Ack>
  <Build>e531_intl_APILW2_5327044_R1</Build>
  <Version>531</Version>
  <ReviewCount>17</ReviewCount>
  <BuyingGuideCount>4</BuyingGuideCount>
  <ProductID type="UPC">085391698920</ProductID>
  <ReviewsAndGuidesURL>http://search.reviews.ebay.com/Message-in-a-Bottle_UPC_085391698920_W0QQfvcsZ1177QQsoprZ2052596QQupvrZ2</ReviewsAndGuidesURL>
  <PageNumber>1</PageNumber>
  <TotalPages>4</TotalPages>
  <BuyingGuideDetails>
    <BuyingGuide>
      <Name>my guide for dvd ...</Name>
      <URL>http://reviews.ebay.com/my-guide-for-dvd-Hana_W0QQugidZ10000000000392676</URL>
      <CategoryID>617</CategoryID>
      <Title>my guide for dvd -- Hana</Title>
      <Text>Share your thoughts and ideas with people all over...</Text>
      <CreationTime>2006-03-14T04:43:29.000Z</CreationTime>
      <UserID>yhan02</UserID>
    </BuyingGuide>
    <BuyingGuide>
      <Name>guide for Message in...</Name>
      <URL>http://reviews.ebay.com/guide-for-Message-in-a-Bottle-1999-DVD-for-e453_W0QQugidZ10000000000393205</URL>
      <CategoryID>617</CategoryID>
      <Title>guide for Message in a Bottle (1999, DVD) -- for e453</Title>
      <Text>Share your thoughts and ideas with people all over...</Text>
      <CreationTime>2006-03-21T07:53:48.000Z</CreationTime>
      <UserID>yhan_uk</UserID>
    </BuyingGuide>
    <BuyingGuide>
      <Name>DVD -- message in a ...</Name>
      <URL>http://reviews.ebay.com/DVD-message-in-a-bottle_W0QQugidZ10000000000391476</URL>
      <CategoryID>4708</CategoryID>
      <Title>DVD -- message in a bottle</Title>
      <Text><P>your thoughts and ideas with people all o...</Text>
      <CreationTime>2006-02-23T22:28:55.000Z</CreationTime>
      <UserID>yhan02</UserID>
    </BuyingGuide>
    <BuyingGuide>
      <Name>DVD : message in a b...</Name>
      <URL>http://reviews.ebay.com/DVD-message-in-a-bottle-Guide-2_W0QQugidZ10000000000391481</URL>
      <CategoryID>4708</CategoryID>
      <Title>DVD : message in a bottle -- Guide 2</Title>
      <Text><P>your thoughts and ideas with people all o...</Text>
      <CreationTime>2006-02-23T22:28:55.000Z</CreationTime>
      <UserID>yhan02</UserID>
    </BuyingGuide>
    <BuyingGuideHub>http://search.reviews.ebay.com/Message-in-a-Bottle-1999-DVD_W0QQsatitleZMessageQ20inQ20aQ20BottleQ20Q281999Q2cQ20DVDQ29QQuqtZg</BuyingGuideHub>
  </BuyingGuideDetails>
  <ReviewDetails>
    <AverageRating>4.0</AverageRating>
    <Review>
      <URL>http://search.reviews.ebay.com/Message-in-a-Bottle_UPC_085391698920_W0QQfvcsZ1177QQsoprZ2052596QQupvrZ2</URL>
      <Title>Tell us about this product and share your opinion with</Title>
      <Rating>4</Rating>
      <Text>Tell us about this product and share your opinion ...</Text>
      <UserID>avaauto7</UserID>
      <CreationTime>2006-08-30T01:00:44.000Z</CreationTime>
    </Review>
    <Review>
      <URL>http://search.reviews.ebay.com/Message-in-a-Bottle_UPC_085391698920_W0QQfvcsZ1177QQsoprZ2052596QQupvrZ2</URL>
      <Title>review for movie</Title>
      <Rating>5</Rating>
      <Text>This movie was touching and heartfelt but sad...</Text>
      <UserID>sell_item</UserID>
      <CreationTime>2006-10-09T09:47:11.000Z</CreationTime>
    </Review>
    <Review>
      <URL>http://search.reviews.ebay.com/Message-in-a-Bottle_UPC_085391698920_W0QQfvcsZ1177QQsoprZ2052596QQupvrZ2</URL>
      <Title>my review  of dvd message in a bottle</Title>
      <Rating>4</Rating>
      <Text>good movie
        kjgejfiogioahhiga;klfjgajd;kjf;akdjgaj...</Text>
      <UserID>kmay7</UserID>
      <CreationTime>2006-10-27T20:09:25.000Z</CreationTime>
    </Review>
    <Review>
      <URL>http://search.reviews.ebay.com/Message-in-a-Bottle_UPC_085391698920_W0QQfvcsZ1177QQsoprZ2052596QQupvrZ2</URL>
      <Title>Write a review for message in a bottle</Title>
      <Rating>5</Rating>
      <Text>Things to avoid:
        Off-topic comments.
        Inappropria...</Text>
      <UserID>snowseller_a03</UserID>
      <CreationTime>2006-06-22T09:13:47.000Z</CreationTime>
    </Review>
    <Review>
      <URL>http://search.reviews.ebay.com/Message-in-a-Bottle_UPC_085391698920_W0QQfvcsZ1177QQsoprZ2052596QQupvrZ2</URL>
      <Title>poor review for Message in a bottle</Title>
      <Rating>1</Rating>
      <Text>What do you like, love, or dislike about it? Why d...</Text>
      <UserID>yhan_motors</UserID>
      <CreationTime>2006-02-28T08:06:10.000Z</CreationTime>
    </Review>
  </ReviewDetails>
</FindReviewsAndGuidesResponse>


Back to list of samples



Back to top

Change History

Version Description
577
2008-08-06
  • ReviewsSort (added): Allows you to specify that ReviewsAndGuides are sorted by CreationTime.
  • SortOrder (added): Used with ReviewSort to specify Ascending or Descending sort order.
565
2008-05-14
  • ProductID (modified): Starting in May 2008, some sites will start migrating some catalogs to a new provider. If you pass in an older product reference ID, eBay will return data related to a corresponding product, if available.
531
2007-21-09
  • (added) New call.

Back to top

User-Contributed Notes