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.
Real estateAutomationLead generation

What it returns

14 fields from the published dataset schema. Export as JSON, CSV or Excel, or read the dataset through the Apify API.

  • listingId
  • title
  • address
  • suburb
  • city
  • region
  • propertyType
  • bedrooms
  • bathrooms
  • priceDisplay
  • rentPerWeek
  • agency
  • listingDate
  • openHomes

Input

Input settings for Trade Me NZ Residential Listings Scraper
SettingTypeRequiredDefaultWhat 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
More input settings for Trade Me NZ Residential Listings Scraper
SettingTypeRequiredDefaultWhat 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.

Cost of Trade Me NZ Residential Listings Scraper results by Apify plan
Apify planPer 1,00010,000 results100,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

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…

9 output fields $0.99 per 1K

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…

15 output fields $0.99 per 1K

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…

11 output fields $0.99 per 1K

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,…

11 output fields $0.99 per 1K

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,…

$0.99 per 1K

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,…

10 output fields $0.99 per 1K

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

Actor updated 2026-11-18 Data synced 2026-11-18
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.

Open in Apify Store