Website logo

Extend a classified

Extends the duration of an active classified listing.

The resulting expiry date of the listing will be the current date and time plus the category-specific extension period. Extension periods are currently either 14 or 21 days. This API is currently supported for classifieds in the following categories: Trade Me Property, Trade Me Motors and Businesses for Sale.

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

<ExtendClassifiedRequest>

ListingId Integer (required) ListingId
ReturnListingDetails Boolean (optional) ReturnListingDetails

Returns

<ListingResponse>

Success Boolean Success
Description String or null Description
ListingId Integer ListingId
Listing <ListedItemDetail> or null Listing
(This type is defined elsewhere)

Example XML Request (switch to JSON)

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

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>
</ListingResponse>

Example JSON Response (switch to XML)

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