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.

Success Boolean

Indicates whether the operation was successful.

Description String or null

The description of the error, if the operation failed.

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">
  <Success>false</Success>
  <Description>ABC</Description>
</ReviewResponse>

Example JSON Response (switch to XML)

{
  "Success": false,
  "Description": "ABC"
}