Website logo

Post a question or comment on a listing

Adds a question (or a comment) to a listing. The seller will be notified.

URL: https://api.trademe.co.nz/v1/listings/{listingId}/addcomment.{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 the comment to.
file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

POST Data

<ListingAddComment>

comment String (required) Comment
FirearmsLicence String (optional) FirearmsLicence
FirearmsLicenceHolder <FirearmsLicenceHolderDetails> (optional) FirearmsLicenceHolder
FirstName String (required) FirstName
MiddleNames String (optional) MiddleNames
LastName String (required) LastName
IsBuyerOlderThan18 Boolean (optional) IsBuyerOlderThan18

Returns

<Question>

A ListingQuestion that contains the added comment.

ListingId Integer ListingId
ListingQuestionId Integer ListingQuestionId
Comment String or null Comment
CommentDate DateTime CommentDate
Answer String or null Answer
AnswerDate DateTime AnswerDate
IsSellerComment Boolean IsSellerComment
AskingMember <Member> or null AskingMember
MemberId Integer MemberId
Nickname String or null Nickname
DateAddressVerified DateTime DateAddressVerified
DateJoined DateTime DateJoined
UniqueNegative Integer UniqueNegative
UniquePositive Integer UniquePositive
FeedbackCount Integer FeedbackCount
IsAddressVerified Boolean IsAddressVerified
IsDealer Boolean IsDealer
IsAuthenticated Boolean IsAuthenticated
Photo String or null Photo

Example XML Request (switch to JSON) 

<ListingAddComment xmlns="http://api.trademe.co.nz/v1">
  <comment>ABC</comment>
  <FirearmsLicence>ABC</FirearmsLicence>
  <FirearmsLicenceHolder>
    <FirstName>ABC</FirstName>
    <MiddleNames>ABC</MiddleNames>
    <LastName>ABC</LastName>
  </FirearmsLicenceHolder>
  <IsBuyerOlderThan18>false</IsBuyerOlderThan18>
</ListingAddComment>

Example JSON Request (switch to XML) 

{
  "comment": "ABC",
  "FirearmsLicence": "ABC",
  "FirearmsLicenceHolder": {
    "FirstName": "ABC",
    "MiddleNames": "ABC",
    "LastName": "ABC"
  },
  "IsBuyerOlderThan18": false
}

Example XML Response (switch to JSON) 

<Question xmlns="http://api.trademe.co.nz/v1">
  <ListingId>123</ListingId>
  <ListingQuestionId>123</ListingQuestionId>
  <Comment>ABC</Comment>
  <CommentDate>2018-01-01T00:00:00Z</CommentDate>
  <Answer>ABC</Answer>
  <AnswerDate>2018-01-01T00:00:00Z</AnswerDate>
  <IsSellerComment>false</IsSellerComment>
  <AskingMember>
    <MemberId>123</MemberId>
    <Nickname>ABC</Nickname>
    <DateAddressVerified>2018-01-01T00:00:00Z</DateAddressVerified>
    <DateJoined>2018-01-01T00:00:00Z</DateJoined>
    <UniqueNegative>123</UniqueNegative>
    <UniquePositive>123</UniquePositive>
    <FeedbackCount>123</FeedbackCount>
    <IsAddressVerified>false</IsAddressVerified>
    <IsDealer>false</IsDealer>
    <IsAuthenticated>false</IsAuthenticated>
    <Photo>ABC</Photo>
  </AskingMember>
</Question>

Example JSON Response (switch to XML) 

{
  "ListingId": 123,
  "ListingQuestionId": 123,
  "Comment": "ABC",
  "CommentDate": "\/Date(1514764800)\/",
  "Answer": "ABC",
  "AnswerDate": "\/Date(1514764800)\/",
  "IsSellerComment": false,
  "AskingMember": {
    "MemberId": 123,
    "Nickname": "ABC",
    "DateAddressVerified": "\/Date(1514764800)\/",
    "DateJoined": "\/Date(1514764800)\/",
    "UniqueNegative": 123,
    "UniquePositive": 123,
    "FeedbackCount": 123,
    "IsAddressVerified": false,
    "IsDealer": false,
    "IsAuthenticated": false,
    "Photo": "ABC"
  }
}