Trademe Properties Spider

The Trademe Properties Spider is an Apify Actor that scrapes residential property listings from Trade Me, New Zealand's premier online marketplace. It extracts detailed data on properties for sale, including pricing, locations, features, and agent contacts, to support efficient data collection for real estate professionals and analysts. This tool streamlines market research and automation, delivering reliable insights without manual effort.

Features

• Comprehensive Data Extraction: Captures key property details like listing ID, title, price, location, and agent information.
• High-Quality Outputs: Includes photo URLs, property specs (bedrooms, bathrooms, area), and agency details for thorough analysis.
• Configurable Limits: Set maximum items to process, allowing control over data volume and runtime.
• API-Based Scraping: Leverages Trade Me's API for fast, reliable data retrieval with minimal errors.
• Structured JSON Output: Produces clean, machine-readable data ideal for integration with databases or analytics tools.
• Pagination Handling: Automatically manages page navigation to collect extensive listings.
• Error Resilience: Built-in handling for common issues like rate limits or API changes.

Input Parameters

Parameter	Type	Required	Description	Example
Url	string	No	The URL for the spider to scrape Trade Me residential properties. This should be a valid API endpoint for property search results.	https://api.trademe.co.nz/v1/search/property/residential.json?page=1&rows=22&return_canonical=true&return_metadata=true&return_ads=true&return_empty_categories=true&return_super_features=true&return_did_you_mean=true&canonical_path=%2Fproperty%2Fresidential%2Fsale&rsqid=3e140f5dac734fe8948a26815db8bad6-001
itemLimit	integer	No	Specifies the maximum number of property items to process. Use this to limit output for testing or focused queries.	10

Example Usage

To run the actor, provide input in JSON format:

{
  "Url": "https://api.trademe.co.nz/v1/search/property/residential.json?page=1&rows=22&return_canonical=true&return_metadata=true&return_ads=true&return_empty_categories=true&return_super_features=true&return_did_you_mean=true&canonical_path=%2Fproperty%2Fresidential%2Fsale&rsqid=3e140f5dac734fe8948a26815db8bad6-001",
  "itemLimit": 10
}

Example output (array of property objects):

[
  {
    "listing_id": 5740810364,
    "title": "Family Ready - Ross Street Renovation",
    "category": "0350-5748-3399-",
    "start_price": 0,
    "start_date": "/Date(1768889420553)/",
    "end_date": "/Date(1773727820553)/",
    "is_featured": true,
    "has_gallery": true,
    "is_bold": true,
    "is_highlighted": true,
    "category_path": "/Trade-Me-Property/Residential/For-Sale",
    "picture_href": "https://trademe.tmcdn.co.nz/photoserver/thumb/2281317303.jpg",
    "region": "Wellington",
    "suburb": "Kilbirnie",
    "price_display": "Deadline sale by 5 Feb",
    "photo_urls": [
      "https://trademe.tmcdn.co.nz/photoserver/thumb/2281317304.jpg",
      "https://trademe.tmcdn.co.nz/photoserver/thumb/2281317305.jpg"
    ],
    "address": "21 Ross Street",
    "district": "Wellington",
    "area": 169,
    "land_area": 381,
    "bathrooms": 2,
    "bedrooms": 4,
    "parking": "",
    "property_type": "House",
    "agency_name": "New Zealand Sotheby's International Realty Wellington",
    "agency_phone": null,
    "agency_website": "https://www.nzsothebysrealty.com/",
    "agent_name": "Steve Rodwell",
    "agent_mobile": "(021) 907948",
    "agent_photo": "https://trademe.tmcdn.co.nz/property/agent_profile/160x160/agent_individual_profile4632223v12.jpg",
    "actor_id": "UlgSWhmHfGboZLrXl",
    "run_id": "y6Lxxh3joyf2rtEea"
  }
]

Use Cases

• Market Research: Analyze property trends, prices, and availability across regions for investment decisions.
• Competitive Intelligence: Monitor competitor listings and agent performance in specific suburbs.
• Price Monitoring: Track price changes and auction details for targeted properties.
• Content Aggregation: Build databases of property listings for real estate websites or apps.
• Academic Research: Collect data for studies on housing markets, demographics, or economic indicators.
• Business Automation: Integrate with CRM systems to automate lead generation for real estate agents.

Installation and Usage

1. Search for "Trademe Properties Spider" in the Apify Store.
2. Click "Try for free" or "Run".
3. Configure input parameters (e.g., URL and item limit).
4. Click "Start" to begin extraction.
5. Monitor progress in the log.
6. Export results in your preferred format (JSON, CSV, Excel).

Output Format

The actor outputs an array of JSON objects, each representing a property listing. Key fields include listing_id (unique identifier), title (property name), price_display (pricing info), region and suburb (location), bedrooms, bathrooms, area, and land_area (specs), photo_urls (array of image links), and agent/agency details like agent_name and agency_website. Dates are in Unix timestamp format, and boolean flags indicate features like is_featured.

Support

For custom/simplified outputs or bug reports, please contact:

• Email: support@getdataforme.com
• Subject line: "custom support"
• Contact form: https://getdataforme.com/contact/

We're here to help you get the most out of this Actor!