Website logo

Save a seller to your favourites

Saves a seller to the currently authenticated user's list of favourite sellers.

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

<SaveSellerRequest>

Email Enumeration (required) EmailOptions
None 0 None
Daily 1 Daily
Every3Days 3 Every3Days
Weekly 7 Weekly
Push Enumeration (optional) PushFrequency
None 0 None
Instant 1 Instant
SellerId Integer (required) SellerId

Returns

<SavedFavouriteResponse>

Details of the saved favourite, including the ID.

SearchId Integer SearchId
Response String or null Response
Saved Boolean Saved
FavouriteType Enumeration FavouriteType
None 0 None
Category 1 Category
Search 3 Search
AttributeSearch 4 AttributeSearch
Seller 6 Seller

Example XML Request (switch to JSON) 

<SaveSellerRequest xmlns="http://api.trademe.co.nz/v1">
  <Email>None</Email>
  <Push>None</Push>
  <SellerId>123</SellerId>
</SaveSellerRequest>

Example JSON Request (switch to XML) 

{
  "Email": 0,
  "Push": 0,
  "SellerId": 123
}

Example XML Response (switch to JSON) 

<SavedFavouriteResponse xmlns="http://api.trademe.co.nz/v1">
  <SearchId>123</SearchId>
  <Response>ABC</Response>
  <Saved>false</Saved>
  <FavouriteType>None</FavouriteType>
</SavedFavouriteResponse>

Example JSON Response (switch to XML) 

{
  "SearchId": 123,
  "Response": "ABC",
  "Saved": false,
  "FavouriteType": 0
}