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

The price of the bold title promotion. Listings with this promotion have a bold title in search results. If the property is not present, then this promotion is not available.

Bundle Number or null

The price of having the feature, bold and gallery promotions. If the property is not present, then this promotion is not available. Note that some categories do not allow certain promotions - in this case only the supported promotions are included in the price.

EndDate Number or null

The price of the scheduled end time promotion. If the property is not present, then this promotion is not available.

Feature Number or null

The price of the feature promotion. Listings with this promotion are shown higher in search results. If the property is not present, then this promotion is not available.

Gallery Number or null

The price of the gallery promotion. Listings with this promotion show photos in search results. If the property is not present, then this promotion is not available.

GalleryPlus Number or null

The price of the gallery plus promotion. Listings with this promotion get the gallery promotion, plus the next two relists also get the gallery promotion if the item doesn't sell. If the property is not present, then this promotion is not available.

Highlight Number or null

The price of the highlight promotion. Listings with this promotion have a bright yellow border. If the property is not present, then this promotion is not available.

Homepage Number or null

The price of featuring the listing on the homepage. If the property is not present, then this promotion is not available.

Listing Number or null

The base price of listing an item. Applies to classifieds and auctions in some categories. Note that in some categories the fee for listing a classified depends on the asking price (or the rateable value/rent per week for properties) - for these categories this property will contain the price at the lowest tier. If this property is not present, then there is no listing fee for this category. For Motors the field is only applicable to Auctions

MultiPhoto Number or null

The price for additional photos. If the property is not present, then this promotion is not available.

Reserve Number or null

The price for having a reserve. If the property is not present, then this promotion is not available.

Subtitle Number or null

The cost of the subtitle promotion. Listings with this promotion have a subtitle in search results and listing pages. If the property is not present, then this promotion is not available.

TenDays Number or null

The price to extend the listing to a duration of 10 days. If the property is not present, then this promotion is not available.

Withdrawal Number or null

The minimum withdrawal fee for a listing. For some categories, including Motors, the withdrawal fee is calculated based on the sale price of the item at the time of the withdrawal. Withdrawing the item in the first hour is fee. Retrieve fees for withdrawing a listing endpoint is used to calculate the correct value.

SuperFeature Number or null

The price for the super feature promotion. Listings with the super feature promotion are listed on the landing page for certain verticals, such as Trade Me Motors. This price is irrelevant for general marketplace listings. This is the price for super feature only - it does not include the feature combo extras. It is only available when adding the super feature promotion to a listing which had it already, but where the super feature period has expired. If the property is not present, then this promotion is not available.

SuperFeatureBundle Number or null

The price for the super feature promotion. Listings with the super feature promotion are listed on the landing page for categories in general marketplace and verticals, such as Trade Me Motors. This price includes feature, bold, highlight and gallery, where applicable. If the property is not present, then this promotion is not available.

HighVolume Number or null

The price for listing more than a set number of listings concurrently. The maximum number of listings you can run without incurring a fee starts at 50, but increases based on the number of items you have sold. See our help page for more information. This fee does not apply to classifieds. This fee is the same for all categories (i.e. it is not category-specific).

ListingFeeTiers Collection of <FeeTier> or null

If this category supports classifieds and the listing fee is dependent on the asking price, then this field will contain a list of pricing tiers. Only applies to classifieds.

MinimumTierPrice Number

The minimum price (may be the sale price, asking price, rateable value or rent per week, depending on the category and the type of fee) for this tier. The maximum price for this tier is defined by the minimum price for the next tier (if this is the last tier, then the maximum price is unlimited).

FixedFee Number

The fixed fee that applies to listings within this tier. If the PercentageFee property is also present, then this fee applies in addition to that one.

PercentageFee Number

The fee that applies to listings within this tier, as a percentage of the price increase over the minimum tier price. For example, if this fee applies to a sale price of $250, the MinimumTierPrice is $200, and the PercentageFee is 4.9, then this fee is 4.9% of the $50 which amounts to $2.45. If the FixedFee property is present, then this fee applies in addition to that one.

MinimumSuccessFee Number

The minimum success fee. Success fees only apply to auctions. If the property is not present, then the minimum success fee is zero.

MaximumSuccessFee Number

The maximum success fee. Success fees only apply to auctions. If the property is not present, then success fees do not apply to this category.

SuccessFeeTiers Collection of <FeeTier> or null

A list of success fee tiers. Only applies to auctions. If the property is not present, then success fees do not apply to this category.

(This type has already been defined)
Branding Number

The price of the branding promotion. Listings with this promotion can have logo and/or banner. If the property is not present, then this promotion is not available.

SecondCategory Number

The price of the second category promotion. Listings with this promotion will also appear in the second category selected.

Discounts Collection of <FeeDiscount> or null

Additional information regarding member specific discounts for this category. The discount values are already applied to the Fees.

Type Enumeration

Fee discount type.

NotSpecified 0

No fee discount specified.

SuccessFee 1

The fee for a successful auction.

Gallery 2

The fee of the gallery promotion.

Feature 3

The fee of the feature promotion.

FeatureCombo 4

The fee of the feature combo promotion.

SuperFeature 5

The fee of the super feature promotion.

Subtitle 6

The fee of the subtitle promotion.

Reserve 7

The fee for having a reserve price.

TenDays 8

The fee for extending the listing to a duration of 10 days.

EndDate 9

The fee of the scheduled end time promotion.

Message String or null

A short description of the fee discount.

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"
    }
  ]
}