Website logo

Sell similar from an existing auction or classified

Sell similar from an existing or expired auction or classified. Creates a new listing without modifying editable fields.

Sell similar copies all data from original listing and applies them to the new listing. The only exceptions are where there are default durations that are applied on sell similar items.

Some categories are currently unsupported (including subcategories): 98 (Livestock), 1349 (Horses).

URL: https://api.trademe.co.nz/v1/Selling/Similar.{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

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

POST Data

<SellSimilarListingRequest>

ListingId Long Integer (required)

The ID of the listing that is being withdrawn, relisted or extended.

ReturnListingDetails Boolean (optional)

Indicates whether full listing details should be returned in the Listing field.

Returns

<ListingResponse>

Success Boolean

Indicates whether the operation was successful.

Description String or null

The description of the error, if the operation failed.

ListingId Long Integer

The ID of the listing.

Listing <ListedItemDetail> or null

The state of the listing, after the listing operation has successfully completed. This field is only present if the ReturnListingDetails parameter is true and the operation was successful. This field will also be missing if there was an error retrieving the listing details. For more information on this field, see the documentation for the listing details API.

(This type is defined elsewhere)
ListingGroupId Long Integer or null

The identifier of the group of related multi-variant listings. Blank if the listing is not multi-variant

Example XML Request (switch to JSON)

<SellSimilarListingRequest xmlns="http://api.trademe.co.nz/v1">
  <ListingId>123</ListingId>
  <ReturnListingDetails>false</ReturnListingDetails>
</SellSimilarListingRequest>

Example JSON Request (switch to XML)

{
  "ListingId": 123,
  "ReturnListingDetails": false
}

Example XML Response (switch to JSON)

<ListingResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
  <ListingId>123</ListingId>
  <Listing> ... </Listing>
  <ListingGroupId>123</ListingGroupId>
</ListingResponse>

Example JSON Response (switch to XML)

{
  "Success": false,
  "Description": "ABC",
  "ListingId": 123,
  "Listing": { ... },
  "ListingGroupId": 123
}