Website logo

Add your review to a listing

Adds your review to a listing. Currently only applicable to services listings. You must be authenticated to post a review. You cannot post a review on your own listing.

URL: https://api.trademe.co.nz/v1/Listings/{listingId}/addreview.{file_format}
HTTP Method: POST
Requires Authentication? Yes
Permission Required: MyTradeMeWrite: Maintain your watchlist, answer questions and post comments.
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

listingId Integer (required)

The ID of the listing to add a review to.
file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

POST Data

<AddReviewRequest>

ReviewText String (required)

The review text (maximum of 500 characters).
Positive Boolean (required)

Indicates whether the review is a positive review (i.e. thumbs up).

Returns

<ReviewResponse>

Information on whether the operation was successful.

Example XML Request (switch to JSON) 

<AddReviewRequest xmlns="http://api.trademe.co.nz/v1">
  <ReviewText>ABC</ReviewText>
  <Positive>false</Positive>
</AddReviewRequest>

Example JSON Request (switch to XML) 

{
  "ReviewText": "ABC",
  "Positive": false
}

Example XML Response (switch to JSON) 

<ReviewResponse xmlns="http://api.trademe.co.nz/v1" />

Example JSON Response (switch to XML) 

{
}