# Lennar Scraper (`solidcode/lennar-scraper`) Actor

\[💰 $0.9 / 1K] Extract Lennar new-construction listings — move-in ready homes, floor plans, and communities with prices, beds, baths, sq ft, lot IDs, HOA and tax rates, schools, amenities, GPS and photos. Filter by price, size, home type and build stage across 97 US markets.

- **URL**: https://apify.com/solidcode/lennar-scraper.md
- **Developed by:** [SolidCode](https://apify.com/solidcode) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.90 / 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 web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## Lennar Scraper

Pull new-construction listings from Lennar at scale — move-in-ready homes, floor plan models, and masterplan communities with current and previous prices, beds, baths, square footage, lot IDs, HOA fees, property tax rates, assigned schools, amenities, GPS coordinates, photo galleries, and 3D tours across 97 US markets in 32 states. Built for real estate investors, homebuilder competitive-analysis teams, mortgage and title lead generation, and PropTech data teams who need builder-direct inventory without stitching it together one metro at a time.

### Why This Scraper?

- **97 Lennar markets across 32 states** — every metro Lennar builds in, from Seattle to Miami. Pick markets one by one, or name a state and get all of its markets at once: Texas alone expands to 8 markets.
- **Three record types in one flat table** — homes for sale, floor plans, and communities, each a single row tagged with `recordType`. No nested objects to unpack in Sheets, Excel, or your warehouse.
- **Nine live filters with 41 preset choices** — price range, square-footage range, bedrooms, bathrooms, 4 home types, 4 build stages, Active Adult vs. Lifestyle communities, community status, and 17 named amenities from swimming pool to pickleball court. They run inside Lennar's own search, so they shrink what you pay for instead of filtering after the fact.
- **Up to 72 fields on a home record with full details on**, 46 without — the 26 extras include HOA fee, property tax rate, assigned schools, community amenities, site-plan documents, and floor-plan diagrams.
- **Price-drop detection built in** — every home ships `price`, `wasPrice`, and a ready-made `priceDropped` flag, plus dated incentive windows via `offerAvailable`, `offerStartDate`, and `offerEndDate`. New-construction price cuts are the sharpest signal in the market.
- **Next Gen and 55+ inventory are first-class filters** — isolate Lennar's "home within a home" Next Gen plans with their private suite, or age-restricted Active Adult communities, in a single dropdown.
- **Sales-office contact on community records** — phone number, street address, and a day-by-day opening schedule labelled Monday through Sunday for the on-site sales team.
- **Whole-market pulls that finish in seconds** — 913 Houston homes in one run (matching Lennar's own published count), 2,666 homes for all of Texas, 2,822 records across six markets. A 100-row starter run completes in about 2 seconds.
- **Photos, renderings, floor plans, and virtual tours on every row** — full galleries, exterior elevation renderings, floor-plan diagrams, self-tour links, and 3D walkthroughs, plus latitude and longitude for mapping.

### Use Cases

**New-Construction Market Research**

- Track builder inventory across 97 metros and 32 states in one dataset
- Compare base prices and price per square foot between Sun Belt markets
- Measure how much move-in-ready stock is sitting in each community
- Follow community pipelines through actively selling, coming soon, and sold out

**Price & Incentive Monitoring**

- Catch price cuts using `wasPrice` against `price` and the `priceDropped` flag
- Track incentive windows with `offerAvailable`, `offerStartDate`, and `offerEndDate`
- Flag promotional badges and Home of the Week picks as they rotate
- Compare estimated monthly payments across floor plans in the same community

**Investment & Underwriting**

- Model carrying costs with real HOA fees, development fees, and property tax rates
- Screen by square footage, bedroom count, and garage bays for build-to-rent portfolios
- Isolate Active Adult (55+) communities for age-targeted buyer strategies
- Build new-construction comparables that resale listings can't give you

**Lead Generation & Sales Intelligence**

- Collect sales-office phone numbers, addresses, and opening hours by market
- Map newly opened communities against your mortgage, title, or insurance footprint
- Spot markets where a builder has just released a new collection
- Feed agent CRMs with fresh builder-direct inventory instead of stale MLS copies

**PropTech & Listing Feeds**

- Power a new-construction search portal with photos, GPS, and virtual tours
- Sync floor-plan diagrams and 3D walkthroughs into your own listing pages
- Keep an internal property database current with scheduled runs
- Enrich existing datasets with builder fields the MLS never carries

### Getting Started

#### One Market, Homes for Sale

The simplest possible run — pick a market and go:

```json
{
    "markets": ["AUS"],
    "resultType": "homes",
    "maxResults": 100
}
```

#### A Whole State, Filtered

Name a state and every one of its Lennar markets is searched. Filters combine, so this returns four-bedroom, move-in-ready homes between $400k and $500k:

```json
{
    "states": ["TX"],
    "resultType": "homes",
    "priceMin": 400000,
    "priceMax": 500000,
    "beds": ["4+"],
    "availability": ["QuickMoveInHomes"],
    "maxResults": 500
}
```

#### Communities with Specific Amenities

```json
{
    "markets": ["TAM", "ORL"],
    "resultType": "communities",
    "communityTypes": ["ActiveAdult"],
    "amenities": ["SWIMMING_POOL", "CLUBHOUSE"],
    "includeDetails": true,
    "maxResults": 200
}
```

#### Scope a Run to a Lennar Link

Paste a market, community, or home page URL and only records under that page come back:

```json
{
    "startUrls": [
        "https://www.lennar.com/new-homes/texas/austin-central-texas/hutto/cotton-brook"
    ],
    "resultType": "all",
    "includeDetails": true,
    "maxResults": 200
}
```

#### Full-Featured Example

```json
{
    "markets": ["HOU", "DAL", "SAN"],
    "states": ["FL"],
    "resultType": "all",
    "includeDetails": true,
    "priceMin": 350000,
    "priceMax": 750000,
    "sqftMin": 1800,
    "beds": ["3+"],
    "baths": ["2+"],
    "homeTypes": ["SingleFamily", "NextGen"],
    "availability": ["QuickMoveInHomes", "UnderConstruction"],
    "communityStatus": ["Active"],
    "maxResults": 5000
}
```

### Input Reference

#### Where to Search

Combine any of the three — nothing is required. With all three left empty, the ten largest markets are searched.

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `markets` | string\[] | `["AUS"]` | One or more Lennar markets (metro areas), chosen from a list of 97 covering 32 states. |
| `states` | string\[] | `[]` | Search every Lennar market in these states. Handy when you want all of Florida rather than picking each metro by hand. |
| `startUrls` | string\[] | `[]` | Paste Lennar.com links — a market page, a community page, or a single home page. Each link is collected in addition to the markets and states above, and a deep link narrows results to that page. |

#### What to Collect

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `resultType` | select | `Homes for sale` | Homes for sale, Communities, Floor plans, or Everything. Homes are individual houses you can buy; communities are the neighbourhoods; floor plans are the models offered in each community. |
| `includeDetails` | boolean | `true` | Adds HOA and tax figures, assigned schools, community amenities, sales-office hours and phone, floor-plan documents, virtual tours, and the full photo gallery. Off gives a leaner 46-field row. |
| `maxResults` | integer | `100` | Total records to return. Set to 0 to collect everything available. With "Everything" selected, the limit is split evenly between homes, communities, and floor plans. |

#### Price & Size

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `priceMin` | integer | — | Only results priced at or above this amount in USD. |
| `priceMax` | integer | — | Only results priced at or below this amount in USD. |
| `sqftMin` | integer | — | Only homes with at least this much living space. |
| `sqftMax` | integer | — | Only homes with at most this much living space. |

#### Home Filters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `beds` | string\[] | `[]` | Minimum bedrooms: 1 or more, through 5 or more. Pick several to widen the search. |
| `baths` | string\[] | `[]` | Minimum bathrooms: 1 or more, 1.5 or more, through 5 or more. |
| `homeTypes` | string\[] | `[]` | Single-family, Multi-family (townhome, condo, duplex), Next Gen (home within a home), or Single story. |
| `availability` | string\[] | `[]` | Build stage: Move-in ready, Under construction, Coming soon, or Future release. |

#### Community Filters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `communityTypes` | string\[] | `[]` | Active Adult (55+) or Lifestyle. |
| `communityStatus` | string\[] | `[]` | Actively selling, Coming soon, or Sold out. Applies to community records and to the community attached to each home and floor plan. |
| `amenities` | string\[] | `[]` | 17 community amenities: swimming pool, clubhouse, fitness center, park, playground, trails, dog park, splash park, community center, basketball court, pickleball court, sport court, soccer field, picnic area, BBQ area, pond, and single-story homes. |

### Output

Every record is one flat row in a single dataset, tagged with `recordType` so homes, communities, and floor plans sit comfortably side by side.

#### Home Record

```json
{
    "recordType": "home",
    "id": "h_895660",
    "name": "Brookstone",
    "url": "https://www.lennar.com/new-homes/texas/austin-central-texas/hutto/cotton-brook/brookstone",
    "address": "412 Silver Maple Trail, Hutto, TX 78634",
    "lotId": "14892512B49",
    "status": "MOVE_IN_READY",
    "price": 412990,
    "wasPrice": 429990,
    "priceDropped": true,
    "beds": 4,
    "baths": 3,
    "halfBaths": 1,
    "sqft": 2384,
    "stories": 2,
    "garages": 2,
    "planName": "Brookstone",
    "isNextGen": false,
    "estimatedMonthlyPayment": 3184.55,
    "offerAvailable": true,
    "offerEndDate": "2026-09-30",
    "estMoveInDate": "2026-10-15",
    "city": "Hutto",
    "stateCode": "TX",
    "zipCode": "78634",
    "marketCode": "AUS",
    "marketName": "Austin / Central Texas",
    "communityName": "Cotton Brook - Watermill Collection",
    "masterplanName": "Cotton Brook",
    "latitude": 30.5427,
    "longitude": -97.5461,
    "hoaFee": 600,
    "hoaFeeIsMonthly": false,
    "taxRate": 2.31,
    "schools": [
        { "name": "Cottonwood Creek Elementary", "grades": "K-5", "county": "Williamson", "isPublic": true }
    ],
    "salesOfficePhone": "512-555-0142",
    "salesOfficeHours": [
        { "day": "Monday", "opens": "10:00", "closes": "18:00", "byAppointmentOnly": false }
    ],
    "images": ["https://www.lennar.com/-/media/brookstone-exterior.jpg?d=1754000000"],
    "virtualTourUrl": "https://my.matterport.com/show/?m=example"
}
```

##### Core & Identity

| Field | Type | Description |
|-------|------|-------------|
| `recordType` | string | Always `home` for this record kind |
| `id` | string | Lennar home identifier |
| `name` | string | Home name, usually the floor plan it is built from |
| `url` | string | Direct Lennar.com link to the home |
| `address` | string | Full street address |
| `lotId` | string | Lot identifier used in Lennar's own paperwork |
| `homesiteNumber` | string | Homesite number within the community |
| `status` | string | Build stage: `MOVE_IN_READY`, `UNDER_CONSTRUCTION`, `COMING_SOON` |
| `planName` | string | Floor plan model this home is built from |
| `planNumber` | string | Floor plan number |
| `planUrl` | string | Link to the floor plan page |
| `isNextGen` | boolean | Next Gen plan, with a private suite, kitchenette, and separate entrance |
| `homeOfTheWeek` | boolean | Featured as home of the week |
| `checkoutType` | string | Online checkout eligibility |
| `scrapedAt` | string | ISO 8601 timestamp of collection |

##### Price & Incentives

| Field | Type | Description |
|-------|------|-------------|
| `price` | number | Current asking price in USD |
| `wasPrice` | number | Previous price — higher than `price` means a cut |
| `priceDropped` | boolean | True when `wasPrice` is above `price` |
| `estimatedMonthlyPayment` | number | Estimated total monthly payment |
| `estimatedMonthlyPaymentBreakdown` | object | Principal and interest, property tax, home insurance, mortgage insurance, HOA fee, development fee, loan type |
| `offerAvailable` | boolean | An incentive offer is running |
| `offerStartDate` | string | Offer window opens |
| `offerEndDate` | string | Offer window closes |
| `badge` | string | Promotional badge shown on the listing |
| `estMoveInDate` | string | Estimated move-in date |

##### Size & Layout

| Field | Type | Description |
|-------|------|-------------|
| `beds` | number | Bedrooms |
| `baths` | number | Full bathrooms |
| `halfBaths` | number | Half bathrooms |
| `sqft` | number | Living area in square feet |
| `stories` | number | Number of storeys |
| `garages` | number | Garage bays |

##### Location & Community

Present on homes, floor plans, and communities alike.

| Field | Type | Description |
|-------|------|-------------|
| `city` | string | City |
| `stateCode` | string | Two-letter state code |
| `stateName` | string | Full state name |
| `zipCode` | string | ZIP code |
| `marketCode` | string | Lennar market code |
| `marketName` | string | Market name, e.g. "Austin / Central Texas" |
| `latitude` | number | Latitude |
| `longitude` | number | Longitude |
| `communityName` | string | Community the record belongs to |
| `communityUrl` | string | Link to that community |
| `communityStatus` | string | `ACTIVE`, `COMING_SOON`, or `SOLD_OUT` |
| `communityNumber` | string | Lennar community number |
| `divisionNumber` | string | Lennar division number |
| `masterplanName` | string | Masterplan the community sits inside |
| `masterplanUrl` | string | Link to the masterplan |

##### Media & Tours

| Field | Type | Description |
|-------|------|-------------|
| `images` | string\[] | Full photo gallery |
| `elevationImage` | string | Exterior rendering |
| `elevationName` | string | Exterior style name |
| `floorPlanImages` | string\[] | Floor-plan diagrams |
| `virtualTourUrl` | string | 3D walkthrough of the home |
| `selfTourUrl` | string | Self-guided tour booking link |
| `planVirtualTourUrl` | string | 3D walkthrough of the floor plan |
| `planVideoTourUrl` | string | Video tour of the floor plan |
| `isTourable` | boolean | Tour available |
| `isReserved` | boolean | Home currently reserved |
| `overview` | string | Marketing description |

##### Community Details

Added to every record type when `includeDetails` is on.

| Field | Type | Description |
|-------|------|-------------|
| `hoaFee` | number | HOA fee amount |
| `hoaFeeIsMonthly` | boolean | True when the HOA fee is billed monthly, false when annually |
| `specialAssessmentIsMonthly` | boolean | Whether a special assessment is billed monthly |
| `developmentFee` | number | Community development fee |
| `depositAmount` | number | Deposit required |
| `taxRate` | number | Property tax rate for the community |
| `schools` | object\[] | Assigned schools with name, grades, county, and public/private flag |
| `amenities` | string\[] | Community amenity description |
| `consultants` | object\[] | Sales consultant phone and introduction |
| `salesOfficePhone` | string | Sales office phone number |
| `salesOfficeAddress` | string | Sales office street address |
| `salesOfficeHours` | object\[] | Opening hours per day, labelled Monday through Sunday, with an appointment-only flag |
| `sitePlanPdf` | string | Community site-plan document |
| `communityVirtualTourUrl` | string | 3D walkthrough of the community |
| `communityIsTourable` | boolean | Community tour available |

#### Community Record

```json
{
    "recordType": "community",
    "id": "c_2214",
    "name": "Cotton Brook - Watermill Collection",
    "url": "https://www.lennar.com/new-homes/texas/austin-central-texas/hutto/cotton-brook",
    "isMasterplan": false,
    "status": "ACTIVE",
    "communityTypes": ["Lifestyle"],
    "priceMin": 329990,
    "priceMax": 512990,
    "bedRange": "3 - 5",
    "bathRange": "2 - 3.5",
    "sqftRange": "1,608 - 2,894",
    "homeCount": 31,
    "planCount": 8,
    "masterplanName": "Cotton Brook",
    "city": "Hutto",
    "stateCode": "TX",
    "marketName": "Austin / Central Texas",
    "hoaFee": 600,
    "hoaFeeIsMonthly": false,
    "taxRate": 2.31,
    "salesOfficePhone": "512-555-0142",
    "scrapedAt": "2026-08-01T09:14:02Z"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `isMasterplan` | boolean | True for a masterplan, false for a single collection inside one |
| `status` | string | `ACTIVE`, `COMING_SOON`, or `SOLD_OUT` |
| `overview` | string | Community description |
| `address` | string | Community or sales office address |
| `communityTypes` | string\[] | Active Adult, Lifestyle, and similar tags |
| `priceMin` | number | Lowest price in the community |
| `priceMax` | number | Highest price in the community |
| `bedRange` | string | Bedroom range as published |
| `bathRange` | string | Bathroom range as published |
| `sqftRange` | string | Square-footage range as published |
| `storiesRange` | string | Storey range as published |
| `homeCount` | number | Homes available in the community |
| `planCount` | number | Floor plans offered |
| `masterplanId` | string | Masterplan identifier, on masterplan rows |
| `collectionCount` | number | Collections inside the masterplan |
| `collections` | object\[] | Each child collection with id, name, link, address, ZIP, starting price, types, home count, and plan count |
| `images` | string\[] | Community photo gallery |

#### Floor Plan Record

```json
{
    "recordType": "floorPlan",
    "id": "p_44120",
    "name": "Sabine",
    "url": "https://www.lennar.com/new-homes/texas/houston/richmond/aliana/sabine",
    "planNumber": "44120",
    "startingPrice": 389990,
    "beds": 4,
    "baths": 3,
    "sqft": 2601,
    "storiesRange": "2",
    "isNextGen": false,
    "communityName": "Aliana - Sterling Collection",
    "marketName": "Houston",
    "energyEfficiencyFeatures": ["Low-E windows", "Smart thermostat"],
    "floorPlanImages": ["https://www.lennar.com/-/media/sabine-floor1.jpg?d=1754000000"],
    "virtualTourUrl": "https://my.matterport.com/show/?m=example",
    "scrapedAt": "2026-08-01T09:14:02Z"
}
```

| Field | Type | Description |
|-------|------|-------------|
| `planNumber` | string | Lennar plan number |
| `status` | string | Plan status |
| `startingPrice` | number | Lowest price this plan is offered at |
| `beds` | number | Bedrooms |
| `baths` | number | Full bathrooms |
| `halfBaths` | number | Half bathrooms |
| `sqft` | number | Living area in square feet |
| `stories` | number | Number of storeys |
| `storiesRange` | string | Storey range offered in the community |
| `isNextGen` | boolean | Next Gen plan with a private suite |
| `energyEfficiencyFeatures` | string\[] | Named energy-efficiency features |
| `hasBayGarage` | boolean | Bay garage configuration |
| `floorPlanImages` | string\[] | Floor-plan diagrams |
| `elevationImages` | string\[] | Exterior renderings |
| `videoTourUrl` | string | Video tour link |

### Tips for Best Results

- **Start with one market and a small limit.** Run `markets: ["AUS"]` with `maxResults: 50` to check the shape of the data, then scale to states or a national pull.
- **Use `states` instead of listing metros by hand.** Texas expands to 8 markets and roughly 2,666 homes in one run — far easier than remembering that Austin, Dallas, Houston, San Antonio, Corpus Christi, Lubbock, Temple, and the Hill Country are all separate markets.
- **A "Future release" build stage returns floor plans, not homes.** A model that hasn't been built yet has no house behind it, so pairing that stage with "Homes for sale" gives zero rows. Switch "What to collect" to Floor plans instead.
- **Read `hoaFee` together with `hoaFeeIsMonthly`.** The same number can mean $600 a month or $600 a year — the flag is what tells them apart, and comparing fees without it will skew every carrying-cost model you build.
- **Masterplan rows don't carry HOA, tax, schools, or office hours.** Those belong to the collections inside them and arrive under `collections[]` on the masterplan row, or on the individual collection rows in the same run.
- **Pick amenities one at a time.** Available amenities differ by market, so selecting five at once often returns nothing. Add them one by one and watch the count.
- **Turn details off when you only need pricing and inventory.** You get a leaner 46-field home row instead of 72, which keeps big multi-state pulls tidy in a spreadsheet.

### Pricing

**From $0.90 per 1,000 results** — a flat pay-per-result rate that undercuts the going market price for Lennar data while covering 97 markets, ten live filters, and three record types. Bronze, Silver, and Gold subscribers pay progressively less; the table below shows the total cost at each discount tier.

| Results | No discount | Bronze | Silver | Gold |
|---------|-------------|--------|--------|------|
| 100 | $0.105 | $0.100 | $0.095 | $0.090 |
| 1,000 | $1.05 | $1.00 | $0.95 | $0.90 |
| 10,000 | $10.50 | $10.00 | $9.50 | $9.00 |
| 100,000 | $105.00 | $100.00 | $95.00 | $90.00 |

A "result" is one row in the dataset — one home, one floor plan, or one community. **No compute or time-based charges — you pay per result, plus a small fixed per-run start fee.** Because the filters run inside Lennar's own search, narrowing by price, size, or build stage reduces your bill rather than adding to it.

### Integrations

Export data in JSON, CSV, Excel, XML, or RSS. Connect to 1,500+ apps via:

- **Zapier** / **Make** / **n8n** — Workflow automation
- **Google Sheets** — Direct spreadsheet export
- **Slack** / **Email** — Notifications on new results
- **Webhooks** — Trigger your own services when a run finishes
- **Apify API** — Full programmatic access

### Legal & Ethical Use

This actor is built for legitimate real estate research, market analysis, and lead generation using publicly available listing information. You are responsible for complying with applicable laws and Lennar's Terms of Service. Do not use extracted data for spam, harassment, or any unlawful purpose, and be mindful of fair housing regulations when working with property, community, and school data.

# Actor input Schema

## `markets` (type: `array`):

Pick one or more Lennar markets (metro areas) to search. Leave empty and choose states below instead, or paste Lennar URLs. If you leave markets, states and URLs all empty, the biggest markets are searched by default.

## `states` (type: `array`):

Search every Lennar market in these states. Handy when you want a whole state rather than picking each metro area one by one.

## `startUrls` (type: `array`):

Paste Lennar.com links — a market page (e.g. 'https://www.lennar.com/new-homes/texas/austin-central-texas'), a community page, or a single home page. Each link is scraped in addition to the markets and states above.

## `resultType` (type: `string`):

Homes are the individual houses you can actually buy (move-in ready, under construction, coming soon). Communities are the neighbourhoods Lennar is building. Floor plans are the models offered in each community.

## `includeDetails` (type: `boolean`):

Add the extras to every record — HOA and tax figures, assigned schools, community amenities, sales office hours and phone, floor plan documents, virtual tours and the full photo gallery. Turn this off for a leaner row with just the headline fields.

## `maxResults` (type: `integer`):

Largest number of records to return in total. The scraper stops asking for new pages once this number is reached, so you may get a few extra from the last page. Markets are searched in the order you listed them. If you chose 'Everything' above, the limit is shared evenly between homes, communities and floor plans. Set to 0 to collect everything available.

## `priceMin` (type: `integer`):

Only include results priced at or above this amount. Leave empty for no lower limit.

## `priceMax` (type: `integer`):

Only include results priced at or below this amount. Leave empty for no upper limit.

## `sqftMin` (type: `integer`):

Only include homes with at least this much living space. Leave empty for no lower limit.

## `sqftMax` (type: `integer`):

Only include homes with at most this much living space. Leave empty for no upper limit.

## `beds` (type: `array`):

Only include homes with at least this many bedrooms. Pick several to widen the search. Leave empty for any number of bedrooms.

## `baths` (type: `array`):

Only include homes with at least this many bathrooms. Leave empty for any number of bathrooms.

## `homeTypes` (type: `array`):

Only include these kinds of home. 'Next Gen' homes include a private suite with its own entrance, kitchenette and living area. Leave empty for every home type.

## `availability` (type: `array`):

Only include homes at these stages. 'Move-in ready' homes are finished and available now. 'Future release' covers models that are offered but not yet built — these come back as floor plan records rather than individual houses. Leave empty for every stage.

## `communityTypes` (type: `array`):

Only include communities of these kinds. 'Active Adult' communities are age-restricted 55+ neighbourhoods. Leave empty for every community type.

## `communityStatus` (type: `array`):

Only include communities in these sales stages. Applies to community records, and to the community attached to each home or floor plan. Leave empty to include every community regardless of status.

## `amenities` (type: `array`):

Only include communities that offer these amenities. Available amenities vary by market, so picking many at once can return nothing. Leave empty to skip this filter.

## Actor input object example

```json
{
  "markets": [
    "AUS"
  ],
  "states": [],
  "startUrls": [],
  "resultType": "homes",
  "includeDetails": true,
  "maxResults": 100,
  "beds": [],
  "baths": [],
  "homeTypes": [],
  "availability": [],
  "communityTypes": [],
  "communityStatus": [],
  "amenities": []
}
```

# Actor output Schema

## `overview` (type: `string`):

Table of every record with the key fields — type, name, price, beds, baths, square feet, build stage, city, state and link.

## `homes` (type: `string`):

Individual homes with address, lot ID, price and previous price, beds, baths, square feet, build stage, estimated monthly payment, GPS and photos.

## `communities` (type: `string`):

Lennar communities with price and size ranges, home counts, HOA and tax figures, assigned schools, amenities, sales office contact and GPS.

## `floorPlans` (type: `string`):

Floor plan models with starting price, beds, baths, square feet, stories, available homesite count, virtual tour and floor plan images.

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "markets": [
        "AUS"
    ],
    "states": [],
    "startUrls": [],
    "resultType": "homes",
    "includeDetails": true,
    "maxResults": 100,
    "beds": [],
    "baths": [],
    "homeTypes": [],
    "availability": [],
    "communityTypes": [],
    "communityStatus": [],
    "amenities": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("solidcode/lennar-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "markets": ["AUS"],
    "states": [],
    "startUrls": [],
    "resultType": "homes",
    "includeDetails": True,
    "maxResults": 100,
    "beds": [],
    "baths": [],
    "homeTypes": [],
    "availability": [],
    "communityTypes": [],
    "communityStatus": [],
    "amenities": [],
}

# Run the Actor and wait for it to finish
run = client.actor("solidcode/lennar-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "markets": [
    "AUS"
  ],
  "states": [],
  "startUrls": [],
  "resultType": "homes",
  "includeDetails": true,
  "maxResults": 100,
  "beds": [],
  "baths": [],
  "homeTypes": [],
  "availability": [],
  "communityTypes": [],
  "communityStatus": [],
  "amenities": []
}' |
apify call solidcode/lennar-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,solidcode/lennar-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/caCYLhjNpjvwcxzdU/builds/CdK2TInjBhh1Z5sK3/openapi.json