Trademe Properties Spider ## Introduction The Trademe Properties Spider is a powerful Apify Actor designed to scrape residential property listings from Trade Me, New Zealand's leading online marketplace. It extracts detailed information about properties for sale, including pricing, location, features, and agent details, enabling users to gather comprehensive real estate data efficiently. This tool is ideal for real estate professionals, researchers, and businesses needing accurate, up-to-date property insights without manual effort. ## Features - Comprehensive Data Extraction: Scrapes key details like listing ID, title, price, location, property features (bedrooms, bathrooms, parking), and agent contact information. - High Reliability: Built to handle Trade Me's API structure, ensuring consistent and accurate data retrieval with minimal errors. - Customizable URLs: Allows users to specify custom API endpoints for targeted scraping of specific property categories or regions. - Structured Output: Delivers data in clean JSON format, ready for integration into databases, analytics tools, or reporting systems. - Performance Optimized: Efficiently processes multiple listings per run, with built-in handling for pagination and large datasets. - No Coding Required: User-friendly interface on Apify Store for easy setup and execution. - Data Enrichment: Includes photo URLs, agency details, and metadata for enriched property profiles. ## Input Parameters | Parameter | Type | Required | Description | Example | |-----------|------|----------|-------------|---------| | Url | string | No | The API URL for the spider to scrape residential property listings from Trade Me. It supports query parameters for pagination, filters, and metadata. | "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" | ## Example Usage ### Input Configuration json { "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" } ### Output Example json [ { "listing_id": 5633618743, "title": "Big Land-Big Views-Big Opportunity", "category": "0350-5748-3399-", "start_price": 0, "start_date": "/Date(1763450521333)/", "end_date": "/Date(1768289173373)/", "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/2264745172.jpg", "region": "Auckland", "suburb": "Maraetai", "price_display": "Auction on 15 Dec, 4:00 pm", "photo_urls": [ "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745182.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745188.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745198.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745217.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745229.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745242.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745249.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745253.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745258.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745264.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745273.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745276.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745282.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745290.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745301.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745307.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745314.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745323.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745332.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745341.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745351.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745361.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745370.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745375.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745384.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745389.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745407.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745417.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2264745424.jpg", "https://trademe.tmcdn.co.nz/photoserver/thumb/2256241844.jpg" ], "address": "96 Maraetai Drive", "district": "Manukau City", "area": null, "land_area": 1151, "bathrooms": 2, "bedrooms": 3, "parking": "2 garage spaces", "property_type": "House", "agency_name": "Ray White Beachlands, (Licensed: REAA 2008)", "agency_phone": "+64-9-5367011", "agency_website": "http://www.rwlighthouse.co.nz ", "agent_name": "Brianne Bignell", "agent_mobile": "(021) 400979", "agent_photo": "https://trademe.tmcdn.co.nz/property/agent_profile/160x160/agent_individual_profile5938761v12.jpg", "actor_id": "hA753kDNAlgEZyRvv", "run_id": "EnUdbifryyhBcKYcO" } ] ## Use Cases - Market Research and Analysis: Analyze property trends, pricing, and availability across regions for investment decisions. - Competitive Intelligence: Monitor competitors' listings to understand market positioning and pricing strategies. - Price Monitoring: Track property values over time to identify opportunities or assess market fluctuations. - Content Aggregation: Build databases of property listings for real estate websites or apps. - Academic Research: Gather data for studies on housing markets, urban development, or economic indicators. - Business Automation: Automate lead generation for real estate agents by extracting contact details and property details. ## Installation and Usage 1. Search for "Trademe Properties Spider" in the Apify Store 2. Click "Try for free" or "Run" 3. Configure input parameters 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 output is a JSON array of objects, each representing a property listing. Key fields include listing_id (unique identifier), title (property name), price_display (formatted price or auction info), region and suburb (location), bedrooms, bathrooms, land_area, property_type, and agent details like agency_name and agent_mobile. Photo URLs are provided in an array for visual content. Dates are in Trade Me's format (e.g., "/Date(timestamp)/"). This structured format ensures easy parsing and integration. ## 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! ---