Trade Me Property Scraper

Extract residential property listings from Trade Me Property — New Zealand's largest property marketplace. Search for homes for sale or rent across all New Zealand regions, filter by price, bedrooms, bathrooms, and property type. Enrich specific listing URLs with full details.

What It Extracts

• Listing details — ID, title, URL, listing date
• Location — address, suburb, city (district), region, GPS coordinates (latitude/longitude)
• Property attributes — type (house/apartment/townhouse/etc.), bedrooms, bathrooms, garages/parking, floor area, land area
• Pricing — sale price, display price ("By Negotiation", "$850,000"), weekly rent for rentals
• Agency info — real estate agency name and agent name
• Open homes — upcoming open home dates and times
• Description — full property description text
• Features — amenity list (heat pump, double glazing, etc.)
• Valuation — rateable/council value (RV) in NZD
• Images — primary image URL and full list of property photos
• Rental extras — available-from date, pets policy

Authentication

This actor uses the Trade Me REST API. You need a free Trade Me developer account to get a consumer key and secret:

1. Go to https://www.trademe.co.nz/developers
2. Register your application (takes under 1 minute)
3. Copy your consumer key and consumer secret into the actor inputs

Input

Field	Type	Required	Description
consumerKey	String	Yes	Trade Me API consumer key
consumerSecret	String	Yes	Trade Me API consumer secret
mode	Select	Yes	searchForSale / searchForRent / byListingUrls
region	Select	No	NZ region (default: All New Zealand)
propertyType	Select	No	Property type filter (default: all types)
minPrice	Integer	No	Minimum price in NZD
maxPrice	Integer	No	Maximum price in NZD
minBedrooms	Integer	No	Minimum number of bedrooms
maxBedrooms	Integer	No	Maximum number of bedrooms
minBathrooms	Integer	No	Minimum number of bathrooms
startUrls	String list	No	Trade Me listing URLs (mode=byListingUrls only)
maxItems	Integer	No	Maximum listings to return (default: 50, max: 5000)

Modes

• searchForSale — Search residential properties listed for sale. Apply region, price, bedroom, and property type filters.
• searchForRent — Search rental properties. Results include weekly rent and availability date.
• byListingUrls — Enrich one or more specific Trade Me listing URLs (e.g. https://www.trademe.co.nz/a/property/residential/sale/listing/12345678).

Available Regions

ID	Region
1	Auckland
2	Bay of Plenty
3	Canterbury
4	Gisborne
5	Hawke's Bay
6	Manawatu / Whanganui
7	Marlborough
8	Nelson / Tasman
9	Northland
10	Otago
11	Southland
12	Taranaki
13	Waikato
14	Wellington
15	West Coast
100	All New Zealand

Output

Each record in the dataset follows this structure:

Field	Type	Description
listingId	String	Trade Me listing ID
title	String	Listing title
url	String	Canonical listing URL
imageUrl	String	Primary photo URL
images	Array	All photo URLs
address	String	Street address
suburb	String	Suburb name
city	String	City / district
region	String	NZ region name
propertyType	String	House / Apartment / Townhouse / etc.
bedrooms	Integer	Number of bedrooms
bathrooms	Integer	Number of bathrooms
garages	Integer	Number of garage / parking spots
landArea	Integer	Land area in square metres
floorArea	Integer	Floor area in square metres
price	Integer	Price in NZD (for-sale listings)
priceDisplay	String	Human-readable price text
rentPerWeek	Integer	Weekly rent in NZD (rental listings)
availableFrom	String	Available-from date (rental listings)
petsOkay	String	Pet policy: Yes / No / Negotiable (rental)
agency	String	Real estate agency name
agentName	String	Agent's full name
listingDate	String	Date first listed (ISO format)
openHomeDates	Array	Upcoming open home date/time strings
description	String	Full property description
features	Array	Amenity list (e.g. "Heat pump", "Double glazing")
latitude	Float	GPS latitude
longitude	Float	GPS longitude
rateable	Integer	Council/rateable value in NZD
isBrokerMarketplace	Boolean	Whether listed through broker marketplace
recordType	String	Always "tradeMeProperty"
scrapedAt	String	ISO 8601 UTC scrape timestamp

Example Output

{
  "listingId": "123456789",
  "title": "Charming 3-Bedroom Home with Garden",
  "url": "https://www.trademe.co.nz/a/property/residential/sale/listing/123456789",
  "imageUrl": "https://photos.trademe.co.nz/property/123/photo1_fullsize.jpg",
  "images": [
    "https://photos.trademe.co.nz/property/123/photo1_fullsize.jpg",
    "https://photos.trademe.co.nz/property/123/photo2_fullsize.jpg"
  ],
  "address": "12 Oak Street",
  "suburb": "Newtown",
  "city": "Wellington City",
  "region": "Wellington",
  "propertyType": "House",
  "bedrooms": 3,
  "bathrooms": 2,
  "garages": 1,
  "landArea": 650,
  "floorArea": 145,
  "price": 850000,
  "priceDisplay": "$850,000",
  "agency": "Ray White Wellington",
  "agentName": "Jane Smith",
  "listingDate": "2026-04-01T00:00:00",
  "openHomeDates": ["2026-05-18T11:00:00", "2026-05-25T14:00:00"],
  "description": "Beautiful home with modern kitchen, double glazing, and a sunny garden.",
  "features": ["Heat pump", "Double glazing", "Garaging: Single lock-up"],
  "latitude": -41.2924,
  "longitude": 174.7787,
  "rateable": 780000,
  "isBrokerMarketplace": false,
  "recordType": "tradeMeProperty",
  "scrapedAt": "2026-05-15T10:30:00+00:00"
}

FAQ

What regions are available? All 15 New Zealand regions plus "All New Zealand" are supported: Auckland, Bay of Plenty, Canterbury, Gisborne, Hawke's Bay, Manawatu/Whanganui, Marlborough, Nelson/Tasman, Northland, Otago, Southland, Taranaki, Waikato, Wellington, and West Coast. Set region to the region ID or leave it blank for a nationwide search.

Can I filter by price? Yes. Set minPrice and/or maxPrice in New Zealand dollars. For example, minPrice: 500000 and maxPrice: 800000 returns properties between $500k and $800k NZD.

How do I get rental listings? Set mode to searchForRent. The output will include rentPerWeek (weekly rent in NZD), availableFrom (move-in date), and petsOkay fields in place of sale price fields.

How many listings can I scrape? Up to 5,000 per run. Trade Me returns 20 listings per page. Set maxItems to control the total. For large nationwide searches, start with maxItems: 50 to preview results before running a full scrape.

Do I need a Trade Me account? You need a free Trade Me developer account to obtain API credentials (consumer key + secret). Register at https://www.trademe.co.nz/developers — it takes under a minute and is free. The API is free for non-commercial use under Trade Me's developer terms.

Can I scrape a specific listing? Yes. Set mode to byListingUrls and provide one or more listing URLs in the startUrls field. Both for-sale and rental listing URLs are accepted.

What property types can I filter by? House, Townhouse, Apartment, Unit, Section/Land, Lifestyle, Rural, New Development, and Carpark.

Are images included? Yes. The imageUrl field contains the primary photo, and images contains all available full-size photos as an array of URLs.

Is GPS location included? When available from Trade Me's data, latitude and longitude are included so you can plot listings on a map.

What is the rateable value? The rateable field is the council valuation (RV) of the property in NZD. This is the government-assessed value used for rate calculations, not the market price.