PART 1: README.md

Tommys Sales Leased List Scraper

Tommys Sales Leased List Scraper is an Apify Actor designed to extract detailed property listings from Tommy's Real Estate website, focusing on sales and lease options across various Wellington locations. It automates the collection of key property data such as titles, prices, descriptions, and agent information, enabling users to gather insights efficiently without manual browsing. This tool is ideal for real estate professionals, researchers, and businesses needing structured data for analysis or integration.

Features

• Comprehensive Data Extraction: Scrapes essential property details including titles, prices, bedrooms, bathrooms, parking, descriptions, and agent contacts.
• Location-Specific Scraping: Supports targeted searches in multiple Wellington suburbs, ensuring relevant and localized results.
• Flexible Listing Types: Handles both sales and lease listings, allowing users to focus on specific market segments.
• High-Performance Crawling: Utilizes CheerioCrawler for fast, reliable data extraction with configurable request limits to manage load.
• Structured Output: Delivers clean JSON data, ready for export to CSV, Excel, or direct API integration.
• Error-Resilient: Includes built-in handling for common scraping challenges like dynamic content or rate limits.
• Easy Integration: Seamlessly works within the Apify platform for scheduling, monitoring, and automated workflows.

Input Parameters

Parameter	Type	Required	Description	Example
listingType	string	No	Specifies the type of listing to scrape: 'sale' for sales listings or 'lease' for lease listings.	"sale"
locationId	string	No	Selects the specific location ID for the search area, corresponding to Wellington suburbs.	"11652" (Mount Victoria)
maxRequestsPerCrawl	integer	No	Sets the maximum number of HTTP requests the crawler can make per run to control resource usage.	100

Example Usage

To run the Actor, provide input parameters in JSON format:

{
  "listingType": "sale",
  "locationId": "11652",
  "maxRequestsPerCrawl": 100
}

Example output in JSON:

[
  {
    "url": "https://tommys.co.nz/listing/134-136-main-street-upper-hutt/",
    "product_title": "134-136 Main Street, Upper Hutt",
    "price": "",
    "bedrooms": "",
    "bathrooms": "",
    "parking": "214sqm",
    "description": "Upper Hutt13387977Enquire for more information.The information presented on this page has been prepared, or is based on information supplied, by the property owner or their legal representative. Whilst all reasonable effort is made to ensure the information accessible on this page is current, we do not perform any independent verification in respect of, and we give no warranty as to, the accuracy or completeness of the data and information accessible on or through this page. Information that has been supplied by the vendor or their agents, Tommy\u2019s Real Estate Limited is merely passing over this information as supplied to us and, to the maximum extent permitted by law, we do not accept any responsibility to any party for the accuracy or use of the document or information herein. You should make your own enquiries and we encourage you to seek your own legal advice before acting on the basis of the provided data and information.Created by Grow My Business",
    "lisiting_id": "",
    "built_year": "1994",
    "property_type": "Retail",
    "agents": [
      {
        "name": "Ben Castle",
        "profile": "https://tommys.co.nz/agents/ben-castle-2/",
        "phone": "021616220",
        "email": null
      }
    ],
    "scraped_at": "2025-10-27T11:55:48.986Z"
  }
]

Use Cases

• Market Research and Analysis: Gather data on property trends, prices, and availability in specific Wellington areas for investment decisions.
• Competitive Intelligence: Monitor competitor listings and agent activities to inform business strategies.
• Price Monitoring: Track rental or sale prices over time to identify market fluctuations.
• Content Aggregation: Compile property data for real estate websites, blogs, or newsletters.
• Academic Research: Collect historical or current data for studies on urban development or housing markets.
• Business Automation: Integrate scraped data into CRM systems or automated reporting tools for streamlined operations.

Installation and Usage

1. Search for "Tommys Sales Leased List Scraper" 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 Actor outputs data in JSON array format, with each object representing a property listing. Key fields include:

• url: Direct link to the listing page.
• product_title: Property title and address.
• price: Listing price (may be empty if not specified).
• bedrooms, bathrooms, parking: Property features (e.g., "214sqm" for parking).
• description: Detailed property description.
• listing_id: Unique identifier (may be empty).
• built_year: Year the property was built.
• property_type: Type of property (e.g., "Retail").
• agents: Array of agent objects with name, profile URL, phone, and email.
• scraped_at: Timestamp of when the data was scraped.

Data is structured for easy parsing and integration into databases or analytics tools.

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!

---

PART 2: Description

Unlock valuable Wellington property insights with Tommys Sales Leased List Scraper! Extract detailed sales and lease listings, including prices, descriptions, and agent contacts from Tommy's Real Estate. Perfect for market research, price monitoring, and competitive analysis. Fast, reliable, and easy to use on Apify. Start scraping today! (248 characters)