---

🏡 Richardsons Listing Spider

The Richardsons Listing Spider is an Apify Actor designed to scrape real estate property listings from Richardsons Real Estate (richardsons.co.nz). It gathers property details such as pricing, address, description, features, images, and listing metadata — all in a clean, structured JSON format.

---

✅ Example Output

[
  {
    "headline": "Coastal Retreat with Spectacular Ocean Views",
    "street": "28 Gray Avenue",
    "suburb": "Kuaotunu",
    "address_full": "28 Gray Avenue, Kuaotunu",
    "description": "Perfectly placed for spectacular ocean views across to Mercury Island, this sun-soaked home is a private retreat just a...",
    "price": "Negotiation",
    "beds": "2",
    "baths": "1",
    "living": "1",
    "type": "Residential",
    "listing_id": "RM4380",
    "detail_url": "https://www.richardsons.co.nz/property/RM4380/28-gray-avenue-kuaotunu/",
    "image_url": "https://webimages.propertysuite.co.nz/richardsons/listing-thumb/236E0/RM4380.jpg",
    "actor_id": "horP2nBJFzTBjjbt1",
    "run_id": "NsYYLTanGupt0HnX1"
  },
  {
    "headline": "Income & Lifestyle",
    "street": "18 Black Jack Road",
    "suburb": "Kuaotunu",
    "address_full": "18 Black Jack Road, Kuaotunu",
    "description": "“Live where others holiday - this rare Kuaotunu mixed-use property offers the freedom to live, earn, and relax in one...",
    "price": "Deadline Sale",
    "beds": "2",
    "baths": "2",
    "living": "1",
    "type": null,
    "listing_id": null,
    "detail_url": "https://www.richardsons.co.nz/property/RM4386/18-black-jack-road-kuaotunu/",
    "image_url": "https://webimages.propertysuite.co.nz/richardsons/listing-thumb/236C6/RM4386.jpg",
    "actor_id": "horP2nBJFzTBjjbt1",
    "run_id": "NsYYLTanGupt0HnX1"
  }
]

---

⚙️ Input Parameters

This Actor does not require a custom input configuration — it automatically crawls and collects property listings from Richardsons' website.

Parameter	Type	Description	Required
N/A	–	No input required for operation	❌

---

🌟 Features

• ✅ Scrapes headline, address, suburb, and full formatted address
• ✅ Extracts beds, baths, living areas, price, property type & listing ID
• ✅ Collects high-resolution image URLs and property detail links
• ✅ Includes Actor ID and Run ID for easy data traceability
• ✅ Lightweight, fast, and reliable Apify implementation

---

💡 Use Cases

• 🏘️ Real estate market monitoring & analytics
• 📊 Property investment research and comparison
• 🛍️ Feed property data into websites or dashboards
• 🤖 Automate property listing updates or alerts

---

📁 Output Format

The scraped results are stored in Apify datasets and can be downloaded in formats like JSON, CSV, Excel, XML, or fetched via API.

---

🛠️ How to Use

1. Open the Actor in Apify: Richardsons Listing Spider
2. Click Run (no input required or customize if needed)
3. View results under the Dataset tab
4. Export or connect via API to your applications

---

🆘 Support

For custom features, simplified outputs, or bug reports:

📧 support@getdataforme.com 🌍 https://getdataforme.com/contact/ Please include a clear subject line (e.g., "Richardsons Listing Spider Support").