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)

The frequency that emails should be sent.
None 0

No emails are sent.
Daily 1

An email is sent every day.
Every3Days 3

An email is sent each third day.
Weekly 7

An email is sent every week.
Push Enumeration (optional)

The frequency that push notifications should be sent.
None 0

Push not enabled for this favourite.
Instant 1

Push is enabled for this favourite.
Label String (optional)

The label of the favourite should be sent.
SellerId Integer (required)

The member ID of the seller to save.

Returns

<SavedFavouriteResponse>

Details of the saved favourite, including the ID.

SearchId Integer

The ID of the saved favourite.
Response String or null

A description of the error, if the operation failed.
Saved Boolean

Indicates whether the favourite was saved.
FavouriteType Enumeration

Indicates what type of favourite was saved.
None 0

Nothing
Category 1

Category
Search 3

General search
AttributeSearch 4

Attributed search
Seller 6

Seller
Label String or null

Display Label of favourite was saved.

Example XML Request (switch to JSON) 

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

Example JSON Request (switch to XML) 

{
  "Email": 0,
  "Push": 0,
  "Label": "ABC",
  "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>
  <Label>ABC</Label>
</SavedFavouriteResponse>

Example JSON Response (switch to XML) 

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