eBay Shopping Web Service

Method: FindReviewsAndGuides

Description

Finds reviews and guides based on the given search criteria.

Input

The input of this method is the document element ns:FindReviewsAndGuidesRequest of type having the structure defined by the following table.

Element  Type  Description 
ns:MessageID  xs:string  If you pass a value in MessageID in a request, we'll return the same value in CorrelationID in the response.
any     
ns:ProductID  ns:ProductIDType  Use this to retrieve reviews (not guides) for one specific product.
ns:UserID  xs:string  Retrieves reviews and guides written by the specified user.
ns:CategoryID  xs:string  Specify a single CategoryID to restrict your query to a specific Guide category.
ns:MaxResultsPerPage  xs:int  Specifies the maximum number of reviews per page (not guides) in the returned list.
ns:PageNumber  xs:int  Specifies the number of the page of data to return in the current call.
ns:ReviewSort  ns:ReviewSortCodeType  Include ReviewSort in your request if you want to sort by a parameter, such as CreationTime.
ns:SortOrder  ns:SortOrderCodeType  Sorts search results in ascending or descending order, in conjunction with the value you specify in ReviewsSort.

Output

The output of this method is the document element ns:FindReviewsAndGuidesResponse of type having the structure defined by the following table.

Element  Type  Description 
ns:Timestamp  xs:dateTime  This value represents the date and time when eBay processed the request.
ns:Ack  ns:AckCodeType  Indicates whether the call was successfully processed by eBay.
ns:Errors  ns:ErrorType  A list of application-level errors or warnings (if any) that were raised when eBay processed the request.
ns:Build  xs:string  This refers to the particular software build that eBay used when processing the request and generating the response.
ns:Version  xs:string  The release version that eBay used to process the request.
ns:CorrelationID  xs:string  If you pass a value in MessageID in a request, we will return the same value in CorrelationID in the response.
any     
ns:ReviewCount  xs:int  Number of returned reviews.
ns:BuyingGuideCount  xs:int  Number of returned buying guides.
ns:ReviewerRank  xs:int  Rank of reviewer if using user search.
ns:TotalHelpfulnessVotes  xs:int  Number of helpfulness votes if using user search.
ns:ProductID  ns:ProductIDType  The eBay or external IDs associated with the product.
ns:ReviewsAndGuidesURL  xs:anyURI  URL to the reviews and guides page.
ns:PageNumber  xs:int  The number of the page of data returned.
ns:TotalPages  xs:int  Indicates the total number of pages of data that could be returned by repeated requests.
ns:BuyingGuideDetails  ns:BuyingGuideDetailsType  Contains information for up to 5 buying guides that match the query.
ns:ReviewDetails  ns:ReviewDetailsType  Contains information about review details.
ns:PositiveHelpfulnessVotes  xs:int  Number of helpfulness votes if using user search.