Sale Search
/api/trademe_property/search_sale
Search residential property for sale with filters, sorting, and pagination
Scrappa's Trade Me Property API returns structured JSON from Trade Me, New Zealand's largest online marketplace and property portal. Search residential property for sale and rental property with price, bedroom, bathroom, property type, region, district, suburb and keyword filters, page through the results, open any listing for its full detail with photos, attributes and agency, and resolve region, district and suburb ids. Scrappa is an independent service and is not affiliated with or endorsed by Trade Me.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/trademe_property/search_sale?region=15&district=47&rows=2" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"data": {
"total_count": 956,
"page": 1,
"page_size": 2,
"has_more": true,
"listings": [
{
"id": 6048028595,
"url": "https://www.trademe.co.nz/a/listing/6048028595",
"title": "Pure magic on The Crescent",
"category": "For Sale",
"property_type": "House",
"price_text": "Price by negotiation",
"start_date": "2026-07-23T08:08:27Z",
"end_date": "2026-10-31T19:43:27Z",
"region": "Wellington",
"district": "Wellington",
"suburb": "Roseneath",
"address": "51 The Crescent",
"bedrooms": 4,
"bathrooms": 2,
"floor_area_sqm": 315,
"land_area_sqm": 407,
"agency": "Luxe Realty, (Licensed: REAA 2008)"
}
]
},
"meta": {
"endpoint_family": "search_sale",
"billable": true
}
}
Structured data for real applications. Here are some ideas.
Poll one region, district or suburb filter on a schedule and compare listing id sets to detect new listings and price changes.
Combine weekly price, bedroom and property type filters to compare rents across New Zealand suburbs.
Sort sale listings by price and filter by bedrooms, property type and area to surface candidates for review.
Use the localities endpoint to build region, district and suburb menus without scraping pages.
Trade Me Property scraper API
The Trade Me Property API is built for property analytics, rental tools, and investor dashboards. Each listing includes title, price text, numeric NZD price or weekly rent, ISO 8601 UTC dates, coordinates, bedrooms, bathrooms, areas, photos, agency and open homes when published. Personal data of members and agents is never returned.
Search sale and rental listings with price, bedroom, bathroom, property type, region, district, suburb and keyword filters.
Sort by price or open home time and page with page and rows up to 100 listings.
Rentals return the weekly rent as a number next to the price text.
Open any listing for the plain-text description, attribute table, photos and agency.
Resolve region, district and suburb ids with the localities endpoint.
Combine region, district, price, bedroom and property type filters to collect matching sale listings with total_count and has_more paging metadata.
Open Trade Me Property Sale Search API docsFilter rentals by weekly price, bedrooms and pets allowed and read price_per_week and available_from as ready-to-use values.
Open Trade Me Property Rental Search API docsOpen a listing by id to get the description, attribute table, photos in three sizes, open homes, agency and view count.
Open Trade Me Property Listing API docsEverything you need in one API.
/api/trademe_property/search_sale
Search residential property for sale with filters, sorting, and pagination
/api/trademe_property/search_rent
Search rental property with weekly price, pets filter, and pagination
/api/trademe_property/listing
Get the full detail, photos, attributes and agency of one listing
/api/trademe_property/localities
List all regions, districts and suburbs with their ids
See how Scrappa compares to the official API.
| Feature | Scrappa | ScrapingBee / ScraperAPI |
|---|---|---|
| Trade Me Property data as JSON | Build your own parser | |
| Weekly rent as a number | Parse it yourself | |
| Region, district and suburb ids | ||
| Price per 1k requests | From $0.20 | Varies by credits per request |
| Unified API key | Yes (80+ APIs) | Scraping only |
| Free tier | 500 credits/month | Trial credits |
No. Scrappa is an independent service and is not affiliated with or endorsed by Trade Me. The Trade Me Property API returns structured JSON from public listing data through a Scrappa API key.
Call the localities endpoint. It returns every region with its districts and suburbs and their numeric ids, which you pass as region, district and suburb to the search endpoints.
Use the 1-based page parameter with rows up to 100. The response returns total_count, page, page_size and has_more. A valid empty result is a successful response and is billed as success.
No. An unknown or expired listing id answers a non-billable 404 with error code NOT_FOUND. Only successful 2xx responses are billed.