Website logo

Retrieve the Top Seller status criteria

Returns Top Seller Criteria

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

URL parameters

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

Returns

<TopSellerCriteria>

Criteria that needs to be met to become a Top Seller

SalesCount Integer

The number of sales needed to qualify for Top Seller status.

SalesValue Number

The total value of sales in dollars needed to qualify for Top Seller status.

SellThroughRate Number

The sell-through rate in percent needed to qualify for Top Seller status.

FeedbackRating Number

The feedback rating needed to qualify for Top Seller status.

InTradeStatus Boolean

The in trade status needed to qualify for Top Seller status.

PeriodStart DateTime

The start date of the qualifying period (in UTC). Only applicable to members that are not top sellers.

PeriodEnd DateTime

The end date of the qualifying period (in UTC). Only applicable to members that are not top sellers.

Example XML Response (switch to JSON)

<TopSellerCriteria xmlns="http://api.trademe.co.nz/v1">
  <SalesCount>123</SalesCount>
  <SalesValue>123.0</SalesValue>
  <SellThroughRate>123.0</SellThroughRate>
  <FeedbackRating>123.0</FeedbackRating>
  <InTradeStatus>false</InTradeStatus>
  <PeriodStart>2018-01-01T00:00:00Z</PeriodStart>
  <PeriodEnd>2018-01-01T00:00:00Z</PeriodEnd>
</TopSellerCriteria>

Example JSON Response (switch to XML)

{
  "SalesCount": 123,
  "SalesValue": 123.0,
  "SellThroughRate": 123.0,
  "FeedbackRating": 123.0,
  "InTradeStatus": false,
  "PeriodStart": "\/Date(1514764800)\/",
  "PeriodEnd": "\/Date(1514764800)\/"
}