eBay Shopping Web Service

Method: FindReviewsAndGuides

Description

Finds reviews and guides based on the given search criteria.

Action

Style

Document

Input (Literal)

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

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

Output (Literal)

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

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