Retrieves a list of curated promotions

Retrieves a list of curated promotions, where each promotion links to a search.

URL:	https://api.trademe.co.nz/v1/SearchPromotions.{file_format}
HTTP Method:	GET
Requires Authentication?	Yes
Permission Required:	None
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.

Returns

Collection of <SearchPromotion>

A list of curated promotions.

Title

String or null

Title

ImageUrl

String or null

ImageUrl

SearchApi

Enumeration

SearchApi

General	0	General
UsedMotors	1	UsedMotors
MotorBoat	2	MotorBoat
MotorBike	3	MotorBike
Residential	4	Residential
Rental	5	Rental
CommercialSale	6	CommercialSale
CommercialLease	7	CommercialLease
Rural	8	Rural
Lifestyle	9	Lifestyle
Flatmate	10	Flatmate
OpenHomes	11	OpenHomes
Retirement	12	Retirement
Job	13	Job
NewHomes	14	NewHomes
Caravan	15	Caravan
Motorhome	16	Motorhome

SearchString

String or null

SearchString

Example XML Response (switch to JSON)

<SearchPromotionCollection xmlns="http://api.trademe.co.nz/v1">
  <SearchPromotion>
    <Title>ABC</Title>
    <ImageUrl>ABC</ImageUrl>
    <SearchApi>General</SearchApi>
    <SearchString>ABC</SearchString>
  </SearchPromotion>
  <SearchPromotion>
    <Title>ABC</Title>
    <ImageUrl>ABC</ImageUrl>
    <SearchApi>General</SearchApi>
    <SearchString>ABC</SearchString>
  </SearchPromotion>
</SearchPromotionCollection>

Example JSON Response (switch to XML)

[
  {
    "Title": "ABC",
    "ImageUrl": "ABC",
    "SearchApi": 0,
    "SearchString": "ABC"
  },
  {
    "Title": "ABC",
    "ImageUrl": "ABC",
    "SearchApi": 0,
    "SearchString": "ABC"
  }
]