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.
Open in Apify Store$0.99 / 1K on Free
Short answer
Trade Me NZ Residential Listings Scraper is an Apify Store Actor that returns 14 published output fields, including listingId, title, address, suburb. It lists $0.99 per 1,000 results on the Free plan (pay per event), $0.49 on the Business plan. It takes 28 input settings; one is required (mode). Last updated Nov 18, 2026.
From the public Store listing and published build schema, synced 2026-11-18.What it returns
14 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.
listingIdtitleaddresssuburbcityregionpropertyTypebedroomsbathroomspriceDisplayrentPerWeekagencylistingDateopenHomes
Input
| Setting | Type | Required | Default | What it does |
|---|---|---|---|---|
| mode | string | Yes | searchForSale | Search residential properties for sale, search rental listings, or refresh a list of property URLs you already track. |
| region | string | No | Auckland | New Zealand region to search. Choose All New Zealand to search nationwide. |
| district | string | No | – | Narrow the search to one district, for example Auckland City or Christchurch City. Enter a district name or Trade Me district ID. |
| suburb | string | No | – | Narrow the search to one suburb, for example Ponsonby or Riccarton. Enter a suburb name or Trade Me suburb ID. |
| searchString | string | No | – | Only return listings whose title or description matches this keyword, for example villa, waterfront or garage. |
| propertyType | string | No | – | Limit results to one type of property. |
| minPrice | integer | No | – | Lowest asking price for sale listings, or lowest weekly rent for rental listings. |
| maxPrice | integer | No | – | Highest asking price for sale listings, or highest weekly rent for rental listings. |
| minBedrooms | integer | No | – | Smallest number of bedrooms to include. Use 0 to include studios. |
| maxBedrooms | integer | No | – | Largest number of bedrooms to include. |
Show the other 18 settings
| Setting | Type | Required | Default | What it does |
|---|---|---|---|---|
| minBathrooms | integer | No | – | Smallest number of bathrooms to include. |
| maxBathrooms | integer | No | – | Largest number of bathrooms to include. |
| minLandArea | integer | No | – | Smallest land area in square metres. |
| maxLandArea | integer | No | – | Largest land area in square metres. |
| minFloorArea | integer | No | – | Smallest floor area in square metres. |
| maxFloorArea | integer | No | – | Largest floor area in square metres. |
| minParking | integer | No | – | Smallest number of garage, carport or off-street parking spaces. |
| maxParking | integer | No | – | Largest number of garage, carport or off-street parking spaces. |
| minLounges | integer | No | – | Smallest number of separate lounges or living areas. |
| maxLounges | integer | No | – | Largest number of separate lounges or living areas. |
| salesMethod | string | No | – | Only return sale listings using this method. Ignored for rental searches. |
| openHomesOnly | boolean | No | false | Return only properties that have an upcoming open home. |
| newHomesOnly | boolean | No | false | Return only new-build properties. |
| homeIncomeOnly | boolean | No | false | Return only home-and-income properties. |
| sortOrder | string | No | Default | Order of the search results. |
| includeDetails | boolean | No | false | Fetch the full listing page data for each result. Adds the description, every photo, agent names and property features, at the cost of one extra request per listing. |
| listingUrls | array | No | [] | Trade Me Property listing URLs or numeric listing IDs. Used when mode is Refresh specific listing URLs. |
| maxItems | integer | No | 50 | Maximum number of listings to save. Trade Me serves up to 50 per page; the actor walks pages until it reaches this limit or the source is exhausted. |
Example input
Built from the input form's published example values and defaults.
{
"mode": "searchForSale",
"region": "Auckland",
"openHomesOnly": false,
"newHomesOnly": false,
"homeIncomeOnly": false,
"sortOrder": "Default",
"includeDetails": false,
"listingUrls": [],
"maxItems": 20
} Inputs for real jobs and stated limits
From the README of the Actor's latest build, read 2026-11-18.
Search houses for sale in Waikato
{
"mode": "searchForSale",
"region": "Waikato",
"propertyType": "house",
"minBedrooms": 3,
"maxPrice": 900000,
"maxItems": 100
} Rentals in Wellington under $650/week
{
"mode": "searchForRent",
"region": "Wellington",
"maxPrice": 650,
"maxItems": 60
} Re-check specific listings
{
"mode": "byListingUrls",
"startUrls": [
"https://www.trademe.co.nz/a/property/residential/sale/listing/4123456",
"https://www.trademe.co.nz/a/property/residential/sale/listing/4123789"
]
} Run it from code or an AI agent
The same run through the Apify API, with the example input. You need an Apify API token; the run is billed to your account at the Store price.
Python
from apify_client import ApifyClient
client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
"mode": "searchForSale",
"region": "Auckland",
"openHomesOnly": False,
"newHomesOnly": False,
"homeIncomeOnly": False,
"sortOrder": "Default",
"includeDetails": False,
"listingUrls": [],
"maxItems": 20
}
run = client.actor("vexaloom-labs/trade-me-nz-residential-listings-scraper").call(run_input=run_input)
if run is None:
raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
print(item) pip install apify-client
JavaScript
import { ApifyClient } from "apify-client";
const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
"mode": "searchForSale",
"region": "Auckland",
"openHomesOnly": false,
"newHomesOnly": false,
"homeIncomeOnly": false,
"sortOrder": "Default",
"includeDetails": false,
"listingUrls": [],
"maxItems": 20
};
const run = await client.actor("vexaloom-labs/trade-me-nz-residential-listings-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items); npm install apify-client
cURL
curl -X POST "https://api.apify.com/v2/actors/vexaloom-labs~trade-me-nz-residential-listings-scraper/run-sync-get-dataset-items" -H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" -d '{"mode":"searchForSale","region":"Auckland","openHomesOnly":false,"newHomesOnly":false,"homeIncomeOnly":false,"sortOrder":"Default","includeDetails":false,"listingUrls":[],"maxItems":20}' Waits for the run and returns the dataset items (runs over 300 seconds return HTTP 408; start an async run instead).
MCP (AI agents)
{
"mcpServers": {
"apify": {
"url": "https://mcp.apify.com?tools=vexaloom-labs/trade-me-nz-residential-listings-scraper",
"headers": {
"Authorization": "Bearer <YOUR_APIFY_TOKEN>"
}
}
}
} Adds this Actor as a tool in an MCP client that takes a remote server URL (Cursor, VS Code, Claude Code) through Apify's hosted MCP server. OAuth sign-in also works without the header. Clients that only start local servers can wrap the URL with npx mcp-remote.
What a run costs
The result rate falls on higher Apify plans. Each figure is the published per-result rate times the number of results.
| Apify plan | Per 1,000 | 10,000 results | 100,000 results |
|---|---|---|---|
| Free plan | $0.99 | $9.90 | $99 |
| Starter plan | $0.82 | $8.20 | $82 |
| Scale plan | $0.66 | $6.60 | $66 |
| Business plan | $0.49 | $4.90 | $49 |
- Every run also has a start event, charged per GB of memory (minimum one): $0.10 on Free, $0.03 on Business. At its default memory of 4 GB a run starts at $0.40 on Free. Fewer, larger runs keep this small.
- The Free plan includes $5 of monthly usage (Apify pricing, checked 2026-11-11); at the Free rate that covers at most about 5,050 results, less start events and platform usage.
- Worked example: 10,000 results in one run on the Free plan cost $10.30 ($9.90 for results + $0.40 start), plus Apify platform usage (compute), billed separately by Apify.
- Pay per event. Platform usage (compute) is billed by Apify on top of the event prices. Compare other tools in the cost estimator.
What people use it for
- Find homes for sale or rent
- Track property listings
Similar Actors
Brazil Rental & Sale Listings by City (QuintoAndar)
Search Brazilian rental and sale property listings by city and transaction type: price breakdown, bedrooms, bathrooms, area, furnishing, and…
Century 21 Listings & Property Detail Finder
Find Century 21 homes for sale or rent by city, county, neighborhood, or ZIP with price and size filters, or look up a property by address with…
ChavesNaMao City Property Listings Extractor
Search ChavesNaMão for sale or rental properties in 15 major Brazilian cities, with price, condominium fee, IPTU, room counts, area and…
Crexi Commercial Property Listings & Pricing Extractor
Collects active commercial real estate listings from Crexi across any US state and 14 property types, with asking price, square footage, location,…
Domain.com.au Property Listings & Agent Data Extractor
Collect Domain.com.au sale, rent and sold property listings by search URL or direct listing URL, with address, price, beds/baths, photos,…
Fotocasa Spain Sale & Rental Listings Scraper
Search Fotocasa listings for sale or rent across Spain by city, property type, price range, and bedrooms. Each result includes price, size,…
Questions people ask
How much does Trade Me NZ Residential Listings Scraper cost?
The published result rate depends on your Apify plan: $0.99 per 1,000 on Free, $0.82 per 1,000 on Starter, $0.66 per 1,000 on Scale, $0.49 per 1,000 on Business. So 10,000 results cost about $9.90 on the Free plan and $4.90 on Business, plus a start fee of $0.10 per run per GB of memory on Free. Platform usage is billed separately.
What data does Trade Me NZ Residential Listings Scraper return?
Its published output schema lists 14 fields: listingId, title, address, suburb, city, region, propertyType, bedrooms, bathrooms, priceDisplay, rentPerWeek, agency, and 2 more. A listed field is not guaranteed to be filled in every row.
What input does Trade Me NZ Residential Listings Scraper need?
Required: mode. Optional settings include region, district, suburb, searchString, propertyType, minPrice.
How do I run Trade Me NZ Residential Listings Scraper from Python or the API?
Use the Apify API client: in Python, ApifyClient(token).actor("vexaloom-labs/trade-me-nz-residential-listings-scraper").call(run_input=...), then read the run's default dataset (run.default_dataset_id); in JavaScript the same call is client.actor("vexaloom-labs/trade-me-nz-residential-listings-scraper").call(input). Without a client, POST the input JSON to https://api.apify.com/v2/actors/vexaloom-labs~trade-me-nz-residential-listings-scraper/run-sync-get-dataset-items with your API token. Ready-to-paste code with the example input is on this page.
Sources
- Trade Me NZ Residential Listings Scraper on Apify Store
- Published build with input and output schema (JSON)
Cite this page
Scraper Finder. "Trade Me NZ Residential Listings Scraper." https://scraperfinder.com/catalogue/trade-me-nz-residential-listings-scraper/ (data checked 2026-11-18).
Run Trade Me NZ Residential Listings Scraper
$0.99 per 1,000 results. Paste the example input above, set your target query, then export the dataset.