Website logo

Get a suggested salary for the given listing details

This method is to retrieve a salary suggestion for the given listing details

URL: https://api.trademe.co.nz/v1/Jobs/Listings/SalarySuggestions.{file_format}
HTTP Method: POST
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.

POST Data

<SalarySuggestionsRequest>

CategoryId Integer (required) CategoryId
RegionId Integer (required) RegionId
DistrictId Integer (required) DistrictId
JobType String (required) JobType
ContractType String (required) ContractType
Title String (required) Title
PayType String (optional) PayType

Returns

<SalarySuggestionsResponse>

Success Boolean Success
BandHigher Integer BandHigher
BandLower Integer BandLower
PayType String or null PayType

Example XML Request (switch to JSON) 

<SalarySuggestionsRequest xmlns="http://api.trademe.co.nz/v1">
  <CategoryId>123</CategoryId>
  <RegionId>123</RegionId>
  <DistrictId>123</DistrictId>
  <JobType>ABC</JobType>
  <ContractType>ABC</ContractType>
  <Title>ABC</Title>
  <PayType>ABC</PayType>
</SalarySuggestionsRequest>

Example JSON Request (switch to XML) 

{
  "CategoryId": 123,
  "RegionId": 123,
  "DistrictId": 123,
  "JobType": "ABC",
  "ContractType": "ABC",
  "Title": "ABC",
  "PayType": "ABC"
}

Example XML Response (switch to JSON) 

<SalarySuggestionsResponse xmlns="http://api.trademe.co.nz/v1">
  <Success>false</Success>
  <BandHigher>123</BandHigher>
  <BandLower>123</BandLower>
  <PayType>ABC</PayType>
</SalarySuggestionsResponse>

Example JSON Response (switch to XML) 

{
  "Success": false,
  "BandHigher": 123,
  "BandLower": 123,
  "PayType": "ABC"
}