# Trademe Property Search Scraper (`stealth_mode/trademe-property-search-scraper`) Actor Scrape TradeMe property search results in bulk — extract listing prices, locations, bedrooms, amenities, agent info, and 45+ fields per property. Perfect for real estate analysts, investors, and developers tracking the NZ market. - **URL**: https://apify.com/stealth\_mode/trademe-property-search-scraper.md - **Developed by:** [Stealth mode](https://apify.com/stealth_mode) (community) - **Categories:** Automation, Developer tools, Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $2.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## 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 ```json { "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** ```json { "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. # Actor input Schema ## `urls` (type: `array`): Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list. ## `ignore_url_failures` (type: `boolean`): If true, the scraper will continue running even if some URLs fail to be scraped. ## `max_items_per_url` (type: `integer`): The maximum number of items to scrape per URL. ## Actor input object example ```json { "urls": [ "https://www.trademe.co.nz/a/property/residential/sale/auckland?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 } ``` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "urls": [ "https://www.trademe.co.nz/a/property/residential/sale/auckland?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }; // Run the Actor and wait for it to finish const run = await client.actor("stealth_mode/trademe-property-search-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "urls": ["https://www.trademe.co.nz/a/property/residential/sale/auckland?page=2"], "ignore_url_failures": True, "max_items_per_url": 20, } # Run the Actor and wait for it to finish run = client.actor("stealth_mode/trademe-property-search-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "urls": [ "https://www.trademe.co.nz/a/property/residential/sale/auckland?page=2" ], "ignore_url_failures": true, "max_items_per_url": 20 }' | apify call stealth_mode/trademe-property-search-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=stealth_mode/trademe-property-search-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Trademe Property Search Scraper", "description": "Scrape TradeMe property search results in bulk — extract listing prices, locations, bedrooms, amenities, agent info, and 45+ fields per property. Perfect for real estate analysts, investors, and developers tracking the NZ market.", "version": "0.0", "x-build-id": "x6DcqwqrSt3c01QfA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/stealth_mode~trademe-property-search-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-stealth_mode-trademe-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/stealth_mode~trademe-property-search-scraper/runs": { "post": { "operationId": "runs-sync-stealth_mode-trademe-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/stealth_mode~trademe-property-search-scraper/run-sync": { "post": { "operationId": "run-sync-stealth_mode-trademe-property-search-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "urls": { "title": "URLs of the property list urls to scrape", "type": "array", "description": "Add the URLs of the property list urls you want to scrape. You can paste URLs one by one, or use the Bulk edit section to add a prepared list.", "items": { "type": "string" } }, "ignore_url_failures": { "title": "Continue running even if some URLs fail to be scraped", "type": "boolean", "description": "If true, the scraper will continue running even if some URLs fail to be scraped." }, "max_items_per_url": { "title": "Max items per URL", "type": "integer", "description": "The maximum number of items to scrape per URL." } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```