Website logo

Retrieve fees for a category

Retrieves a list of fees for a specific category.

Some categories are currently unsupported (including subcategories): 350 (Real Estate), 5000 (Jobs) and 36 (Businesses for sale).

This API is deprecated in favour of the category details API.

URL: https://api.trademe.co.nz/v1/categories/{category}/fees.{file_format}
HTTP Method: GET
Requires Authentication? No
Permission Required: Public
Supported Formats: XML, JSON
Rate Limited? No

URL parameters

category String (required)

The number of the category to retrieve fees for.
file_format Enumeration (required) The format of the response.
xml Serialize responses into XML.
json Serialize responses into JSON.

Returns

<ListingFees>

Bold Number or null Bold
Bundle Number or null Bundle
EndDate Number or null EndDate
Feature Number or null Feature
Gallery Number or null Gallery
GalleryPlus Number or null GalleryPlus
Highlight Number or null Highlight
Homepage Number or null Homepage
Listing Number or null Listing
MultiPhoto Number or null MultiPhoto
Reserve Number or null Reserve
Subtitle Number or null Subtitle
TenDays Number or null TenDays
Withdrawal Number or null Withdrawal
SuperFeature Number or null SuperFeature
SuperFeatureBundle Number or null SuperFeatureBundle
HighVolume Number or null HighVolume
ListingFeeTiers Collection of <FeeTier> or null ListingFeeTiers
MinimumTierPrice Number MinimumTierPrice
FixedFee Number FixedFee
PercentageFee Number PercentageFee
MinimumSuccessFee Number MinimumSuccessFee
MaximumSuccessFee Number MaximumSuccessFee
SuccessFeeTiers Collection of <FeeTier> or null SuccessFeeTiers
(This type has already been defined)
Branding Number Branding
SecondCategory Number SecondCategory
Discounts Collection of <FeeDiscount> or null Discounts
Type Enumeration Type
NotSpecified 0 NotSpecified
SuccessFee 1 SuccessFee
Gallery 2 Gallery
Feature 3 Feature
FeatureCombo 4 FeatureCombo
SuperFeature 5 SuperFeature
Subtitle 6 Subtitle
Reserve 7 Reserve
TenDays 8 TenDays
EndDate 9 EndDate
Message String or null Message

Examples

https://api.trademe.co.nz/v1/Categories/1443/Fees.xml - Retrieves the fees for the antiques > advertising category.

Example XML Response (switch to JSON) 

<ListingFees xmlns="http://api.trademe.co.nz/v1">
  <Bold>123.0</Bold>
  <Bundle>123.0</Bundle>
  <EndDate>123.0</EndDate>
  <Feature>123.0</Feature>
  <Gallery>123.0</Gallery>
  <GalleryPlus>123.0</GalleryPlus>
  <Highlight>123.0</Highlight>
  <Homepage>123.0</Homepage>
  <Listing>123.0</Listing>
  <MultiPhoto>123.0</MultiPhoto>
  <Reserve>123.0</Reserve>
  <Subtitle>123.0</Subtitle>
  <TenDays>123.0</TenDays>
  <Withdrawal>123.0</Withdrawal>
  <SuperFeature>123.0</SuperFeature>
  <SuperFeatureBundle>123.0</SuperFeatureBundle>
  <HighVolume>123.0</HighVolume>
  <ListingFeeTiers>
    <FeeTier>
      <MinimumTierPrice>123.0</MinimumTierPrice>
      <FixedFee>123.0</FixedFee>
      <PercentageFee>123.0</PercentageFee>
    </FeeTier>
    <FeeTier>
      <MinimumTierPrice>123.0</MinimumTierPrice>
      <FixedFee>123.0</FixedFee>
      <PercentageFee>123.0</PercentageFee>
    </FeeTier>
  </ListingFeeTiers>
  <MinimumSuccessFee>123.0</MinimumSuccessFee>
  <MaximumSuccessFee>123.0</MaximumSuccessFee>
  <SuccessFeeTiers>
    <FeeTier />
    <FeeTier />
  </SuccessFeeTiers>
  <Branding>123.0</Branding>
  <SecondCategory>123.0</SecondCategory>
  <Discounts>
    <FeeDiscount>
      <Type>NotSpecified</Type>
      <Message>ABC</Message>
    </FeeDiscount>
    <FeeDiscount>
      <Type>NotSpecified</Type>
      <Message>ABC</Message>
    </FeeDiscount>
  </Discounts>
</ListingFees>

Example JSON Response (switch to XML) 

{
  "Bold": 123.0,
  "Bundle": 123.0,
  "EndDate": 123.0,
  "Feature": 123.0,
  "Gallery": 123.0,
  "GalleryPlus": 123.0,
  "Highlight": 123.0,
  "Homepage": 123.0,
  "Listing": 123.0,
  "MultiPhoto": 123.0,
  "Reserve": 123.0,
  "Subtitle": 123.0,
  "TenDays": 123.0,
  "Withdrawal": 123.0,
  "SuperFeature": 123.0,
  "SuperFeatureBundle": 123.0,
  "HighVolume": 123.0,
  "ListingFeeTiers": [
    {
      "MinimumTierPrice": 123.0,
      "FixedFee": 123.0,
      "PercentageFee": 123.0
    },
    {
      "MinimumTierPrice": 123.0,
      "FixedFee": 123.0,
      "PercentageFee": 123.0
    }
  ],
  "MinimumSuccessFee": 123.0,
  "MaximumSuccessFee": 123.0,
  "SuccessFeeTiers": [
    {
    },
    {
    }
  ],
  "Branding": 123.0,
  "SecondCategory": 123.0,
  "Discounts": [
    {
      "Type": 0,
      "Message": "ABC"
    },
    {
      "Type": 0,
      "Message": "ABC"
    }
  ]
}