Website logo

Retrieve questions for a listing

Retrieves the list of questions (and associated answers) for a listing.

URL: https://api.trademe.co.nz/v1/listings/{listingId}/questions.{file_format}
HTTP Method: GET
Requires Authentication? Yes
Permission Required: None
Supported Formats: XML, JSON
Rate Limited? Yes

URL parameters

listingId Integer (required)

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

Query String parameters

page Integer (optional)

The page number of the set of results to return, starting from 1. Defaults to 1.
rows Integer (optional)

The page size; also the maximum number of questions to return. Defaults to 10.

Returns

<Questions>

A list of questions and answers.

TotalCount Integer TotalCount
Page Integer Page
PageSize Integer PageSize
List Collection of <Question> or null InnerList
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
Email String or null Email
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 Response (switch to JSON) 

<Questions xmlns="http://api.trademe.co.nz/v1">
  <TotalCount>123</TotalCount>
  <Page>123</Page>
  <PageSize>123</PageSize>
  <List>
    <Question>
      <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>
        <Email>ABC</Email>
        <UniqueNegative>123</UniqueNegative>
        <UniquePositive>123</UniquePositive>
        <FeedbackCount>123</FeedbackCount>
        <IsAddressVerified>false</IsAddressVerified>
        <IsDealer>false</IsDealer>
        <IsAuthenticated>false</IsAuthenticated>
        <Photo>ABC</Photo>
      </AskingMember>
    </Question>
    <Question>
      <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>
        <Email>ABC</Email>
        <UniqueNegative>123</UniqueNegative>
        <UniquePositive>123</UniquePositive>
        <FeedbackCount>123</FeedbackCount>
        <IsAddressVerified>false</IsAddressVerified>
        <IsDealer>false</IsDealer>
        <IsAuthenticated>false</IsAuthenticated>
        <Photo>ABC</Photo>
      </AskingMember>
    </Question>
  </List>
</Questions>

Example JSON Response (switch to XML) 

{
  "TotalCount": 123,
  "Page": 123,
  "PageSize": 123,
  "List": [
    {
      "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)\/",
        "Email": "ABC",
        "UniqueNegative": 123,
        "UniquePositive": 123,
        "FeedbackCount": 123,
        "IsAddressVerified": false,
        "IsDealer": false,
        "IsAuthenticated": false,
        "Photo": "ABC"
      }
    },
    {
      "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)\/",
        "Email": "ABC",
        "UniqueNegative": 123,
        "UniquePositive": 123,
        "FeedbackCount": 123,
        "IsAddressVerified": false,
        "IsDealer": false,
        "IsAuthenticated": false,
        "Photo": "ABC"
      }
    }
  ]
}