/trademe/properties

curl --request POST \
  --url https://api.anysite.io/api/trademe/properties \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "listing": "<string>",
  "timeout": 300
}
'

[
  {
    "id": 123,
    "@type": "@trademe_listing",
    "title": "<string>",
    "url": "<string>",
    "description": "<string>",
    "category_name": "<string>",
    "region": "<string>",
    "suburb": "<string>",
    "price_display": "<string>",
    "sale_method": "<string>",
    "sale_date": "<string>",
    "address": "<string>",
    "district": "<string>",
    "bedrooms": 123,
    "bathrooms": 123,
    "ensuites": 123,
    "toilets": 123,
    "garage_parking": 123,
    "off_street_parking": 123,
    "property_type": "<string>",
    "ownership_type": "<string>",
    "floor_area": "<string>",
    "land_area": "<string>",
    "decade_built": "<string>",
    "wall_material": "<string>",
    "roof_material": "<string>",
    "capital_value": "<string>",
    "land_value": "<string>",
    "improvement_value": "<string>",
    "certificate_of_title": "<string>",
    "legal_description": "<string>",
    "broadband": "<string>",
    "latitude": 123,
    "longitude": 123,
    "view_count": 123,
    "bidder_and_watcher_count": 123,
    "listed_at": "<string>",
    "image": "<string>",
    "images": [],
    "broadband_technologies": [],
    "attributes": [],
    "open_homes": [],
    "recent_local_sales": [],
    "schools": [],
    "member": {
      "id": 123,
      "@type": "@trademe_member",
      "nickname": "<string>",
      "suburb": "<string>",
      "region": "<string>",
      "feedback_count": 123,
      "unique_positive": 123,
      "unique_negative": 123,
      "is_address_verified": true,
      "is_authenticated": true,
      "is_in_trade": true,
      "joined_at": "<string>"
    },
    "agency": {
      "id": 123,
      "@type": "@trademe_agency",
      "name": "<string>",
      "phone": "<string>",
      "image": "<string>",
      "is_real_estate_agency": true,
      "is_licensed": true,
      "agents": []
    }
  }
]

/trademe

/trademe/properties

Get full TradeMe property listing details by listing ID (or listing URL): address, price and sale method, bedrooms/bathrooms/parking, floor and land area, property type, council valuation, certificate of title, broadband availability, description, photo gallery, open-home times, in-zone local schools and the advertiser (private member and/or licensed real-estate agency with its agents).

Price: 1 credit

💡 AI Hint: Fetch a single TradeMe (New Zealand) property listing by numeric listing ID or a listing URL. Returns one item with id, title, url, description, region/suburb/district, address, price_display and sale_method (asking_price/auction/tender/negotiation/deadline_sale) with sale_date, bedrooms/bathrooms/ensuites/toilets/garage_parking/off_street_parking, property_type, ownership_type, floor_area, land_area, decade_built, wall_material/roof_material, capital_value/land_value/improvement_value, certificate_of_title, legal_description, broadband, latitude/longitude, view_count, bidder_and_watcher_count, listed_at, image+images, broadband_technologies, attributes (full council/TradeMe attribute list), open_homes, recent_local_sales, schools (in-zone primary/intermediate/secondary with distance) and the advertiser: member (private seller with feedback) and agency (licensed real-estate agency with REAA details and agents).

⚠️ Common errors: 412: Listing not found (well-formed but nonexistent, expired or removed listing)

POST

api

trademe

properties

/trademe/properties

curl --request POST \
  --url https://api.anysite.io/api/trademe/properties \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "listing": "<string>",
  "timeout": 300
}
'

[
  {
    "id": 123,
    "@type": "@trademe_listing",
    "title": "<string>",
    "url": "<string>",
    "description": "<string>",
    "category_name": "<string>",
    "region": "<string>",
    "suburb": "<string>",
    "price_display": "<string>",
    "sale_method": "<string>",
    "sale_date": "<string>",
    "address": "<string>",
    "district": "<string>",
    "bedrooms": 123,
    "bathrooms": 123,
    "ensuites": 123,
    "toilets": 123,
    "garage_parking": 123,
    "off_street_parking": 123,
    "property_type": "<string>",
    "ownership_type": "<string>",
    "floor_area": "<string>",
    "land_area": "<string>",
    "decade_built": "<string>",
    "wall_material": "<string>",
    "roof_material": "<string>",
    "capital_value": "<string>",
    "land_value": "<string>",
    "improvement_value": "<string>",
    "certificate_of_title": "<string>",
    "legal_description": "<string>",
    "broadband": "<string>",
    "latitude": 123,
    "longitude": 123,
    "view_count": 123,
    "bidder_and_watcher_count": 123,
    "listed_at": "<string>",
    "image": "<string>",
    "images": [],
    "broadband_technologies": [],
    "attributes": [],
    "open_homes": [],
    "recent_local_sales": [],
    "schools": [],
    "member": {
      "id": 123,
      "@type": "@trademe_member",
      "nickname": "<string>",
      "suburb": "<string>",
      "region": "<string>",
      "feedback_count": 123,
      "unique_positive": 123,
      "unique_negative": 123,
      "is_address_verified": true,
      "is_authenticated": true,
      "is_in_trade": true,
      "joined_at": "<string>"
    },
    "agency": {
      "id": 123,
      "@type": "@trademe_agency",
      "name": "<string>",
      "phone": "<string>",
      "image": "<string>",
      "is_real_estate_agency": true,
      "is_licensed": true,
      "agents": []
    }
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

listing

string

required

TradeMe listing ID or a listing URL containing it

Minimum string length: 1

Examples:

"5995989628"

"https://www.trademe.co.nz/a/property/residential/sale/.../listing/5995989628"

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

integer

required

@type

string

default:@trademe_listing

title

string | null

url

string | null

description

string | null

category_name

string | null

region

string | null

suburb

string | null

price_display

string | null

sale_method

string | null

sale_date

string | null

address

string | null

district

string | null

bedrooms

integer | null

bathrooms

integer | null

ensuites

integer | null

toilets

integer | null

garage_parking

integer | null

off_street_parking

integer | null

property_type

string | null

ownership_type

string | null

floor_area

string | null

land_area

string | null

decade_built

string | null

wall_material

string | null

roof_material

string | null

capital_value

string | null

land_value

string | null

improvement_value

string | null

certificate_of_title

string | null

legal_description

string | null

broadband

string | null

latitude

number | null

longitude

number | null

view_count

integer | null

bidder_and_watcher_count

integer | null

listed_at

string | null

image

string | null

images

string[]

broadband_technologies

TrademeBroadbandTechnology · object[]

Show child attributes

attributes

TrademeListingAttribute · object[]

Show child attributes

open_homes

TrademeOpenHome · object[]

Show child attributes

recent_local_sales

TrademeRecentSale · object[]

Show child attributes

schools

TrademeSchool · object[]

Show child attributes

member

TrademeMember · object

Show child attributes

agency

TrademeAgency · object

Show child attributes

/trademe/agents/search /trademe/properties/search