Website logo

Add a listing to your watchlist

Adds a listing to the authenticated user's watchlist. Alternatively see the Add a listing to your watchlist with options endpoint for more options.

URL: https://api.trademe.co.nz/v1/MyTradeMe/WatchList/{listingId}.{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 to the watchlist.

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

Returns

<WatchListResponse>

Details on whether the operation succeeded.

Success Boolean

Indicates whether the operation was successful.

Description String or null

The description of the error, if the operation failed.

Example XML Response (switch to JSON)

<WatchListResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <Description>ABC</Description>
</WatchListResponse>

Example JSON Response (switch to XML)

{
  "Success": false,
  "Description": "ABC"
}