TradeMe Property Search Scraper: Extract NZ Real Estate Listings at Scale

---

What Is TradeMe Property?

TradeMe.co.nz is New Zealand's largest online marketplace, and its property section is the dominant platform for residential real estate listings across the country. From Auckland apartments to rural South Island properties, TradeMe Property aggregates listings from private sellers and agencies alike.

Manually collecting this data — prices, locations, property specs, open home schedules — is impractical at any meaningful scale. The TradeMe Property Search Scraper automates extraction from search result pages, turning paginated listings into structured, analysis-ready datasets.

---

Overview

This scraper targets TradeMe property search result pages (not individual listings), collecting summary data for every property returned by a search. It is suited for:

• Investors monitoring price trends by suburb or region
• Real estate analysts building comparable market datasets
• Developers feeding property aggregators or valuation tools
• Researchers studying housing supply and demand across NZ regions

---

Input Format

{
  "urls": [
    "https://www.trademe.co.nz/a/property/residential/sale/auckland?page=2"
  ],
  "ignore_url_failures": true,
  "max_items_per_url": 50
}

Field	Type	Description
urls	string[]	One or more TradeMe property search result page URLs to scrape. Supports any search filter combination (region, property type, price range, etc.). Add multiple URLs to cover multiple pages or searches.
ignore_url_failures	boolean	If true, the scraper continues when a URL fails rather than stopping the entire run. Recommended for bulk jobs. Default: true.
max_items_per_url	integer	Maximum number of property listings to collect per URL. Default prefill: 20. Set higher (e.g., 50) to capture more results per search page.

Tip: To scrape multiple pages of the same search, add each paginated URL separately: ?page=1, ?page=2, etc. You can also vary search filters (suburb, price range, property type) across URLs in the same run.

---

Output Format

Sample output

{
  "listing_id": 5415992408,
  "title": "Slick Design with Harbour Views",
  "category": "0350-5748-3399-",
  "start_price": 0,
  "start_date": "2025-07-11T13:03:11.507Z",
  "end_date": "2026-06-30T05:05:11.507Z",
  "listing_length": null,
  "is_featured": true,
  "has_gallery": true,
  "is_bold": true,
  "is_highlighted": true,
  "as_at": "2026-05-08T17:14:48.206Z",
  "category_path": "/Trade-Me-Property/Residential/For-Sale",
  "picture_href": "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887307.jpg",
  "region_id": 1,
  "region": "Auckland",
  "suburb_id": 89,
  "suburb": "City Centre",
  "note_date": "1970-01-01T00:00:00.000Z",
  "reserve_state": 3,
  "is_classified": true,
  "open_homes": [],
  "geographic_location": {
    "latitude": -36.8514743,
    "longitude": 174.7555495,
    "northing": 5920166,
    "easting": 1756512,
    "accuracy": 1
  },
  "price_display": "Asking price $679,000",
  "photo_urls": [
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887309.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2140431886.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887316.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887317.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887318.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887320.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887322.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887323.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887324.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887325.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2229887328.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2200972075.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2172425849.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2073359057.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2125799253.jpg",
    "https://trademe.tmcdn.co.nz/photoserver/thumb/2098416383.jpg"
  ],
  "additional_data": {
    "bullet_points": [],
    "tags": []
  },
  "canonical_path": "/property/residential/sale/auckland/auckland-city/city-centre/listing/5415992408",
  "listing_extras": [
    "premium_listing"
  ],
  "member_id": 4548234,
  "listing_platform": 1,
  "allows_pickups": 1,
  "address": "45 Union Street",
  "district": "Auckland City",
  "amenities": "Minutes from City Centre, Ponsonby, Motorway onramp, Mt Eden and more",
  "area": 49,
  "bathrooms": 1,
  "bedrooms": 1,
  "listing_group": "PROPERTY",
  "parking": "1",
  "property_type": "Apartment",
  "adjacent_suburb_names": [
    "Parnell",
    "Newton",
    "Ponsonby",
    "Freemans Bay",
    "City Centre",
    "Saint Marys Bay",
    "Newmarket",
    "Arch Hill",
    "Eden Terrace",
    "Grafton",
    "Wynyard Quarter"
  ],
  "adjacent_suburb_ids": [
    41,
    82,
    83,
    88,
    89,
    91,
    99,
    3256,
    135,
    136,
    3566
  ],
  "district_id": 7,
  "agency": {
    "id": 7739,
    "name": "Apartment Specialists Auckland, (Licensed: REAA 2008)",
    "phone_number": "+64-800-697376",
    "website": "http://www.apartmentspecialists.co.nz/",
    "logo": "https://trademe.tmcdn.co.nz/tm/property/agent_logos/4548234-10.jpg",
    "branding": {
      "background_color": "#9f1c21",
      "text_color": "#ffffff",
      "stroke_color": "#9f1219",
      "office_location": "",
      "large_banner_u_r_l": "https://trademe.tmcdn.co.nz/tm/property/agent_logos/office_branding/4548234-office_branding-5.jpg"
    },
    "logo2": "https://trademe.tmcdn.co.nz/tm/property/agent_logos/4548234-3.logo2.jpg",
    "agents": [
      {
        "__type": "PropertyAgent:http://api.trademe.co.nz/v1",
        "full_name": "DeMaio Vilela",
        "mobile_phone_number": "(021) 1616146",
        "office_phone_number": "(021) 1616146",
        "photo": "https://trademe.tmcdn.co.nz/property/agent_profile/160x160/agent_individual_profile8594743v1.jpg",
        "url_slug": "DeMaio-Vilela",
        "testimonials_count": 0,
        "reviews_count": 0,
        "membership_type": 2
      },
      {
        "__type": "PropertyAgent:http://api.trademe.co.nz/v1",
        "full_name": "Rory Hunt",
        "mobile_phone_number": "(021) 1616146",
        "office_phone_number": "(021) 1616146",
        "photo": "https://trademe.tmcdn.co.nz/property/agent_profile/160x160/agent_individual_profile7891605v2.jpg",
        "url_slug": "Rory-Hunt",
        "testimonials_count": 0,
        "reviews_count": 0,
        "membership_type": 2
      }
    ],
    "is_real_estate_agency": true,
    "is_licensed_property_agency": true
  },
  "total_parking": 1,
  "premium_package_code": "PlatinumPackage",
  "property_sale_information": {
    "property_sale_type": 1,
    "property_date_of_sale": "2026-06-30T05:05:11.507Z"
  },
  "from_url": "https://www.trademe.co.nz/a/property/residential/sale/auckland?page=2"
}

Each listing returns up to 47 fields. Below is a field-by-field breakdown:

Identification & Listing Metadata

Field	Meaning
Listing ID	TradeMe's unique identifier for the listing
Title	Listing headline as shown in search results
Category	TradeMe category code (e.g., residential/sale)
Category Path	Full hierarchical category path
Canonical Path	SEO-canonical URL path for the listing
Listing Platform	Platform the listing was created on
Listing Group	Grouping classification within TradeMe
Listing Extras	Additional listing feature flags or metadata
Premium Package Code	Code indicating any premium listing package applied
Is Featured	Whether the listing has featured placement (true/false)
Has Gallery	Whether the listing includes a photo gallery
Is Bold	Whether the listing title is displayed in bold
Is Highlighted	Whether the listing has highlighted styling

Pricing & Sale Information

Field	Meaning
Start Price	Listed asking or starting price
Price Display	Formatted price string as shown to users (e.g., "By Negotiation", "$850,000")
Reserve State	Whether the reserve price has been met (auction context)
Property Sale Information	Structured sale method details (auction, deadline, price by negotiation, etc.)

Dates & Timing

Field	Meaning
Start Date	Date the listing went live
End Date	Date the listing expires or closes
Listing Length	Total duration the listing runs
As At	Timestamp of when the data snapshot was taken
Note Date	Date of any associated note or update

Location

Field	Meaning
Region ID	Numeric ID for the region (e.g., Auckland)
Region	Region name
Suburb ID	Numeric ID for the suburb
Suburb	Suburb name
District	District within the region
District ID	Numeric ID for the district
Address	Street address (may be partial or approximate)
Geographic Location	Latitude/longitude coordinates
Adjacent Suburb Names	Neighbouring suburb names
Adjacent Suburb IDs	Numeric IDs for adjacent suburbs

Property Specifications

Field	Meaning
Property Type	Type of property (e.g., house, apartment, townhouse)
Bedrooms	Number of bedrooms
Bathrooms	Number of bathrooms
Parking	Parking spaces included
Total Parking	Combined total parking count
Area	Floor or land area
Amenities	List of property amenities (e.g., heat pump, dishwasher)

Media & Visuals

Field	Meaning
Picture Href	Primary thumbnail image URL
Photo URLs	Full array of listing photo URLs

Seller & Agency

Field	Meaning
Member ID	TradeMe member ID of the listing owner
Agency	Real estate agency details (name, logo, contact) if applicable
Is Classified	Whether the listing is a classified-style ad
Allows Pickups	Pickup flag (typically false for property)

Open Homes & Additional Data

Field	Meaning
Open Homes	Scheduled open home dates and times
Additional Data	Supplementary structured data returned by the API

---

How to Use

1. Build your search URL — Go to TradeMe Property, apply filters (region, type, price range), and copy the search results page URL.
2. Add pagination — For large searches, add ?page=2, ?page=3, etc. as separate entries in the urls array.
3. Configure limits — Set max_items_per_url to match expected results per page (TradeMe typically shows 20–25 per page).
4. Run the scraper — Start the actor and monitor progress in the run log.
5. Export — Download results as JSON, CSV, or Excel.

Best practices:

• Keep ignore_url_failures: true for multi-URL runs.
• Use specific search filters in your URL to narrow results and improve data relevance.
• If results seem truncated, verify the page actually contains listings before scraping.

---

Use Cases & Business Value

• Market analysis: Track median prices, days-on-market, and listing volumes by suburb
• Investment research: Identify underpriced properties or emerging neighbourhoods
• Data aggregation: Build NZ property portals or comparison tools
• Academic study: Analyse housing affordability and supply trends across NZ regions

---

Conclusion

The TradeMe Property Search Scraper delivers comprehensive, structured property data from New Zealand's primary real estate platform — covering everything from pricing and specs to open home schedules and agency details. With flexible URL-based input and 47 output fields, it is a practical foundation for any NZ property data workflow.