Trade Me NZ Residential Listings Scraper
Pricing
from $0.49 / 1,000 results
Trade Me NZ Residential Listings Scraper
Search Trade Me Property for homes for sale or rent across any New Zealand region, filtered by price, bedrooms, bathrooms and property type, or refresh a list of listing URLs you already track.
Pricing
from $0.49 / 1,000 results
Rating
0.0
(0)
Developer
vexaloom-labs
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
12 hours ago
Last modified
Categories
Features
Share
Trade Me is New Zealand's largest property marketplace, with homes for sale and rentals listed in every region from Northland to Southland. This actor collects residential listings straight from Trade Me Property's public search data, runs entirely without an account, cookie, API key or proxy setup, and returns clean rows ready for analysis, alerts or a CRM.
What you can do
- Search homes for sale with price, bedroom, bathroom, land area, floor area, parking, living area, property type and sale-method filters.
- Search rental listings with weekly rent, bedroom, bathroom, parking and property-type filters, plus available-from and tenant details.
- Refresh listings you already track by pasting Trade Me Property URLs or numeric listing IDs.
- Narrow by location with a region, district or suburb, or search all of New Zealand at once.
- Order the results by featured, price, newest or the earliest open home.
- Walk the full result set automatically. Trade Me serves up to 50 listings per page; the actor requests page after page until it reaches your limit or the source runs out.
- Optionally load full details for every search result to add the description, every photo, agent names and property features.
No login or developer application is needed, so the actor works the same for every user.
Inputs
| Input | Default | What it does |
|---|---|---|
mode | searchForSale | searchForSale, searchForRent or byListingUrls. |
region | Auckland | One of the 15 New Zealand regions, or All New Zealand. |
district | – | Optional district name or Trade Me district ID. |
suburb | – | Optional suburb name or Trade Me suburb ID. |
searchString | – | Optional keyword matched against the listing title and description. |
propertyType | All types | House, apartment, townhouse, unit, section, lifestyle/dwelling or bare land. |
minPrice / maxPrice | – | Asking price for sale searches, weekly rent for rental searches. |
minBedrooms / maxBedrooms | – | Bedroom range. Use 0 to include studios. |
minBathrooms / maxBathrooms | – | Bathroom range. |
minLandArea / maxLandArea | – | Land area range in square metres. |
minFloorArea / maxFloorArea | – | Floor area range in square metres. |
minParking / maxParking | – | Garage, carport and off-street parking range. |
minLounges / maxLounges | – | Separate living-area range. |
salesMethod | Any method | Auction, negotiation, tender, deadline sale or asking price. |
openHomesOnly | false | Keep only listings with an upcoming open home. |
newHomesOnly | false | Keep only new-build listings. |
homeIncomeOnly | false | Keep only home-and-income listings. |
sortOrder | Default | Featured first, lowest price, highest price, latest listings or earliest open home. |
includeDetails | false | Load the full detail view for each search result (description, all photos, agents, features). |
listingUrls | – | Trade Me listing URLs or numeric IDs for byListingUrls. |
maxItems | 50 | Upper limit for the run, from 1 to 5,000. |
Old saved tasks that still send startUrls are handled automatically: those URLs are treated as listingUrls.
Output
Every dataset item is one property. Empty values are omitted rather than written as null.
| Field | Description |
|---|---|
listingId | Trade Me listing ID. |
url | Canonical Trade Me Property listing URL. |
title | Listing headline. |
address | Full display address, or the best address text Trade Me provides. |
streetAddress | Street portion of the address exactly as listed. |
suburb, city | Suburb and district/city. |
region, regionId | New Zealand region and its Trade Me ID. |
districtId, suburbId | Trade Me location IDs. |
propertyId | Agency's property reference, when published (common on rentals). |
propertyType | House, apartment, townhouse, unit, section, dwelling or bare land. |
bedrooms, bathrooms | Room counts. |
landArea, floorArea | Square metres, when published. |
garages, totalParking | Total parking spaces. |
parking | Parking description, for example 2 Car Garage. |
lounges, toilets, studies, ensuites | Additional room counts, when published. |
price, priceDisplay | Numeric asking price (when the listing shows one) and the original price text. Auction, tender and negotiation listings keep the label without inventing a number. |
rentPerWeek, rentPerWeekDisplay | Weekly rent in NZD for rentals, or the original rent text when no clean number exists. |
rateableValue | Council rateable value (RV) in NZD, when published. |
agency, agencyPhone, agencyWebsite | Listing agency details. |
agentName, agentNames | Listing agent name(s). |
listingDate, expiryDate | Listing start and end dates in YYYY-MM-DD. |
saleMethod, saleDate | Sale method and auction/tender/deadline date for for-sale listings. |
description | Full description (up to 2,000 characters) when full details are loaded. |
features | Feature lines from the listing detail view, such as broadband or smoke alarm. |
imageUrl, images | Main photo and every photo, using full-size URLs. |
latitude, longitude | GPS coordinates. |
openHomes | Upcoming open-home objects with ISO start and end timestamps. |
availableFrom | Rental availability date. |
smokersOkay, maxTenants, whiteware, idealTenant, amenities | Rental terms, when published. |
broadband, smokeAlarm | Connectivity and safety details from the detail view. |
viewCount, watcherCount | Public view and watcher counts from the detail view. |
suburbAverageSalePrice | Recent average sale price for the suburb, when Trade Me publishes it. |
recordType | Always tradeMeProperty. |
scrapedAt | UTC scrape timestamp. |
Examples
Search the first 100 Auckland homes for sale between NZ$700,000 and NZ$1,200,000 with at least three bedrooms:
{"mode": "searchForSale","region": "Auckland","minPrice": 700000,"maxPrice": 1200000,"minBedrooms": 3,"sortOrder": "PriceAsc","maxItems": 100}
Refresh three listings you already follow:
{"mode": "byListingUrls","listingUrls": ["https://www.trademe.co.nz/a/property/residential/sale/auckland/auckland-city/epsom/listing/6226341247","6224742628","6236406095"]}
How it works
The actor reads the same public search and listing data that powers the Trade Me Property website. It requests 50 listings per page, de-duplicates by listing ID and stops at your maxItems limit or when Trade Me has no more matching listings. Optional detail requests reuse the same cookieless connection. Transient rate limits and server errors are retried with backoff.
Limitations
- Trade Me serves at most 50 listings per search request. The actor pages through the result set, but a single run is capped at 5,000 saved listings; split a very large search by region, price band or property type.
- Pets-allowed status is not exposed in Trade Me's public listing data, so it cannot be returned.
- New-development, rural and commercial listings sit in separate Trade Me categories and are outside this residential actor.
- Some fields are conditional by nature: an auction listing has no numeric price, a brand-new listing may not have GPS coordinates yet, and open homes only exist for properties that schedule them.
- Trade Me can change its public data format at any time. The actor validates every response and reports a clear status message rather than saving partial or fabricated rows.
Data source
Public Trade Me Property search and listing data at trademe.co.nz, read without authentication, cookies or user-supplied credentials.