# Lennar.com Scraper (`shahidirfan/lennar-com-scraper`) Actor

Extract Lennar home listings, prices, and developer data for real estate intelligence. Automate property scraping with floor plans, community details, and pricing. Perfect for market research, competitive analysis, and real estate platforms.

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

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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 Homes Scraper

Extract Lennar home listing data from Find-a-Home pages with market-level targeting and clean, structured results. Collect pricing, beds, baths, square footage, community details, plan details, and location metadata in one dataset. Built for real estate monitoring, investment analysis, and listing intelligence workflows.

### Features

- **Market-focused extraction** - Collect listings for specific state and market combinations.
- **Clean output records** - Null and empty values are removed before saving.
- **Rich property coverage** - Includes homesite, plan, community, city, market, and state metadata.
- **Scalable pagination** - Pulls large result sets with configurable limits.
- **Flexible filtering input** - Supports advanced filter objects when needed.

### Use Cases

#### Real Estate Market Tracking
Monitor available inventory, pricing shifts, and listing status changes in specific Lennar markets.

#### Investment Research
Build datasets for comparing price bands, home sizes, and community-level opportunity zones.

#### Competitive Intelligence
Track how inventory and pricing evolve by city, community, and plan type over time.

#### Lead Qualification Pipelines
Feed structured new-home data into CRM or qualification workflows for sales teams.

---

### Input Parameters

| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| `startUrl` | String | No | `https://www.lennar.com/find-a-home?state=FL&market=MIA` | Find-a-Home URL used to auto-detect state and market query params. |
| `results_wanted` | Integer | No | `20` | Maximum number of output records to save. |
| `max_pages` | Integer | No | `10` | Maximum pages to request. |
| `proxyConfiguration` | Object | No | `{"useApifyProxy": true}` | Proxy settings for stable production runs. |

---

### Output Data

Each dataset item can contain:

| Field | Type | Description |
|-------|------|-------------|
| `record_type` | String | `homesite` or `plan` |
| `id` | String | Primary listing ID |
| `status` | String | Listing status |
| `price` | Number | Current price |
| `beds` | Number | Bedrooms |
| `baths` | Number | Bathrooms |
| `half_baths` | Number | Half bathrooms |
| `sqft` | Number | Square footage |
| `address` | String | Street address |
| `city_name` | String | City |
| `market_code` | String | Market code |
| `state_code` | String | State code |
| `community_name` | String | Community name |
| `plan_name` | String | Plan name |
| `url` | String | Detail URL |
| `collected_at` | String | ISO timestamp |

Additional community, pricing, media, and metadata fields are included when available.

---

### Usage Examples

#### Basic Miami Market Run

```json
{
  "startUrl": "https://www.lennar.com/find-a-home?state=FL&market=MIA",
  "results_wanted": 20
}
````

#### Higher Volume Run

```json
{
  "startUrl": "https://www.lennar.com/find-a-home?state=FL&market=MIA",
  "results_wanted": 50,
  "max_pages": 10
}
```

#### Extended Pagination Window

```json
{
  "startUrl": "https://www.lennar.com/find-a-home?state=FL&market=MIA",
  "results_wanted": 40,
  "max_pages": 20
}
```

***

### Sample Output

```json
{
  "record_type": "homesite",
  "id": "h_760409",
  "homesite_id": "h_760409",
  "lot_id": "9396603304",
  "status": "MOVE_IN_READY",
  "price": 376349,
  "beds": 3,
  "baths": 2.5,
  "sqft": 1423,
  "address": "35871 SW 178 CT",
  "city_name": "Miami",
  "market_code": "MIA",
  "state_code": "FL",
  "community_name": "Seaview Collection",
  "plan_name": "Caspian",
  "url": "https://www.lennar.com/new-homes/florida/miami/miami/del-mar/seaview-collection/caspian/9396603304",
  "collected_at": "2026-04-03T00:00:00.000Z"
}
```

***

### Tips for Best Results

#### Start Small

- Begin with `results_wanted: 20` to validate output quickly.
- Increase gradually for larger production collections.

#### Tune Pagination

- Keep `max_pages` high enough for your target volume.
- Use `results_wanted: 20` for fast QA-friendly runs.

#### Use Valid Market Codes

- Ensure `startUrl` includes valid `state` and `market` query params.
- Example: `https://www.lennar.com/find-a-home?state=FL&market=MIA`.

#### Use Proxies for Reliability

- Enable `proxyConfiguration` for long-running or frequent jobs.
- Residential traffic pools can improve consistency for high-volume usage.

***

### Integrations

Connect your data with:

- **Google Sheets** - Share listing snapshots with non-technical teams.
- **Airtable** - Build searchable housing intelligence tables.
- **Make** - Trigger downstream workflows after every run.
- **Zapier** - Connect listing updates to alerts and internal tools.
- **Webhooks** - Deliver records to custom services in real time.

#### Export Formats

- **JSON** - Native structured output
- **CSV** - Spreadsheet workflows
- **Excel** - Reporting and dashboards
- **XML** - Legacy system compatibility

***

### Frequently Asked Questions

#### How many listings can I collect?

You can collect as many as available in the selected market, limited by your `results_wanted` and `max_pages` settings.

#### Why are some fields missing in certain rows?

Only values present on the source side are saved. Empty and null values are intentionally removed.

#### Can I run this for other states and markets?

Yes. Provide a different `startUrl` with the target `state` and `market` query params.

#### Is this suitable for scheduled monitoring?

Yes. The actor is designed for repeatable runs and works well with scheduling.

***

### Support

For issues or feature requests, use the Apify Console issue and support channels.

#### Resources

- [Apify Documentation](https://docs.apify.com/)
- [Apify API Reference](https://docs.apify.com/api/v2)
- [Apify Schedules](https://docs.apify.com/platform/schedules)

***

### Legal Notice

This actor is intended for lawful data collection and analysis. You are responsible for complying with website terms, local laws, and all applicable regulations when using extracted data.

# Actor input Schema

## `startUrl` (type: `string`):

A Lennar Find-a-Home URL with state and market query params.

## `results_wanted` (type: `integer`):

Maximum number of records to save.

## `max_pages` (type: `integer`):

Safety cap for pagination loops.

## `proxyConfiguration` (type: `object`):

Proxy settings. Apify Proxy is recommended for stable production runs.

## Actor input object example

```json
{
  "startUrl": "https://www.lennar.com/find-a-home?state=FL&market=MIA",
  "results_wanted": 20,
  "max_pages": 10,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

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

No description

# 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 = {
    "startUrl": "https://www.lennar.com/find-a-home?state=FL&market=MIA",
    "results_wanted": 20,
    "max_pages": 10
};

// Run the Actor and wait for it to finish
const run = await client.actor("shahidirfan/lennar-com-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 = {
    "startUrl": "https://www.lennar.com/find-a-home?state=FL&market=MIA",
    "results_wanted": 20,
    "max_pages": 10,
}

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

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

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

```

## CLI example

```bash
echo '{
  "startUrl": "https://www.lennar.com/find-a-home?state=FL&market=MIA",
  "results_wanted": 20,
  "max_pages": 10
}' |
apify call shahidirfan/lennar-com-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=shahidirfan/lennar-com-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Lennar.com Scraper",
        "description": "Extract Lennar home listings, prices, and developer data for real estate intelligence. Automate property scraping with floor plans, community details, and pricing. Perfect for market research, competitive analysis, and real estate platforms.",
        "version": "1.0",
        "x-build-id": "PHaAeyarwXDIKqHsL"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/shahidirfan~lennar-com-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-shahidirfan-lennar-com-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/shahidirfan~lennar-com-scraper/runs": {
            "post": {
                "operationId": "runs-sync-shahidirfan-lennar-com-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/shahidirfan~lennar-com-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-shahidirfan-lennar-com-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "startUrl": {
                        "title": "Start URL",
                        "type": "string",
                        "description": "A Lennar Find-a-Home URL with state and market query params."
                    },
                    "results_wanted": {
                        "title": "Results Wanted",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Maximum number of records to save.",
                        "default": 20
                    },
                    "max_pages": {
                        "title": "Maximum API Pages",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Safety cap for pagination loops.",
                        "default": 10
                    },
                    "proxyConfiguration": {
                        "title": "Proxy Configuration",
                        "type": "object",
                        "description": "Proxy settings. Apify Proxy is recommended for stable production runs.",
                        "default": {
                            "useApifyProxy": true
                        }
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
