# Lennar Homes, Communities & Floor Plans Scraper (`abotapi/lennar-scraper`) Actor Scrape Lennar new-home communities, move-in-ready homes and floor plans. Extract prices, monthly payment breakdowns, price drops, beds, baths, square footage, coordinates, amenities, virtual tours and 50+ fields. Search by state or paste Lennar URLs. - **URL**: https://apify.com/abotapi/lennar-scraper.md - **Developed by:** [Abot API](https://apify.com/abotapi) (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 $1.00 / 1,000 listing 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 Scraper Extract new-home data from lennar.com, one of America's largest homebuilders, at scale. This actor pulls entire states of communities and move-in-ready homes with firm prices, full monthly-payment breakdowns, price drops, floor plans, square footage, amenities, virtual tours, and map coordinates. ### Why this scraper? - **Three record types, one run:** communities and master-planned communities (neighbourhood summaries), move-in-ready homes (available homes with firm prices), and floor plans (specs, elevations, virtual tours, walkthroughs). - **Whole states in one pass:** one state returns every community and every available home Lennar lists there — hundreds to thousands of records. - **50+ fields per record**, including a full estimated monthly payment breakdown (principal & interest, property tax, home insurance, mortgage insurance, HOA), original vs current price (so you can spot price drops), plan starting prices, badges, and GPS coordinates. - **Search or URL mode:** pick states from a list, or paste any lennar.com/new-homes state or community page. - **Built-in cost controls:** an optional traffic budget and a hard record cap keep trial runs small and predictable. - **Optional detail crawl:** turn on floor plans to also collect per-plan specs, elevation images, virtual tours, community amenities, sales consultants, and reviews. ### Data you get > Sample shapes below. Values are illustrative placeholders, not from a live listing. #### Community record | Field | Example | | --- | --- | | recordType | community | | resultKind | mpc | | communityName | Sample Ranch | | status | ACTIVE | | badge | Amenity Rich | | priceLabel | From the $300s | | priceFrom | From $325K | | bedRange / bathRange | 3 - 5 / 2 - 3 | | sqftRange | 1,600 - 3,200 sq. ft. | | city / market | Sample City / TAM | | latitude / longitude | 28.0000 / -82.0000 | | url | https://www.lennar.com/new-homes/state/market/city/sample-ranch | #### Move-in-ready home record | Field | Example | | --- | --- | | recordType | homesite | | address | 100 Sample Drive #101 | | price | 345000 | | wasPrice | 365000 | | priceDrop | 20000 | | beds / baths / halfBaths | 3 / 2 / 0 | | sqft | 1,741 | | status | MOVE_IN_READY | | planName | Sample Plan | | estimatedMonthlyTotal | 2450.00 | | estimatedMonthlyPayment | { principalAndInterest, propertyTax, homeInsurance, mortgageInsurance, approximateHoaFee } | | url | https://www.lennar.com/new-homes/state/.../101 | #### Floor plan record (detail crawl) | Field | Example | | --- | --- | | recordType | plan | | planName | Sample Plan | | beds / baths | 3 / 2 | | sqft | 1,448 | | startingPrice | 313000 | | elevationImages | [ { title, url } ] | | virtualTourUrl | https://... | | communityName | Sample Ranch | Every record also includes a `raw` field with the complete upstream object, so nothing is ever silently dropped. ### Input - **mode** — `search` (pick states) or `url` (paste links). - **states** — one or more US states (search mode). - **includeCommunities / includeHomesites** — choose which record types to collect. - **enrichDetails** — also collect floor plans + community amenities, consultants, and reviews (one extra page per community). - **startUrls** — lennar.com/new-homes state or community pages (url mode). - **maxItems** — cap the total records (default 20; 0 = no limit). - **proxy** — connection settings (Apify Proxy recommended). ### Example input ```json { "mode": "search", "states": ["Florida", "Texas"], "includeCommunities": true, "includeHomesites": true, "enrichDetails": false, "maxItems": 100 } ```` ### Output Results are written to the dataset, one item per record, tagged by `recordType`. Use the **Overview** and **Move-in homes** dataset views, or export to JSON, CSV, or Excel. You can also pipe results straight into Notion, Airtable, or Linear via the optional MCP connectors. # Actor input Schema ## `mode` (type: `string`): How to choose what to scrape. 'search' iterates the states you pick; 'url' scrapes specific lennar.com/new-homes pages you paste (a state landing page, or a community page for its floor plans). ## `states` (type: `array`): One or more US states to scrape. Each state returns every community and move-in-ready home Lennar lists there. Only applies in 'search' mode. ## `includeCommunities` (type: `boolean`): Output one record per community / master-planned community with price, bed, bath, sqft ranges, badge, brand, status, and coordinates. ## `includeHomesites` (type: `boolean`): Output one record per available home with a firm price, full estimated monthly payment breakdown (principal & interest, taxes, insurance, HOA), beds, baths, square footage, plan, and status. ## `enrichDetails` (type: `boolean`): Output one record per floor plan offered in each community (plan name, specs, elevation images, virtual tour, walkthrough) plus community amenities, sales consultants, and reviews. This fetches one extra page per community, so it is slower and billed separately. Leave off for the fast, cheap community + home overview. ## `startUrls` (type: `array`): lennar.com URLs to scrape: a state page (lennar.com/new-homes/florida) collects that whole state; a community page (lennar.com/new-homes/florida/.../angeline) returns its floor plans and community detail. Only applies in 'url' mode. ## `maxItems` (type: `integer`): Stop after this many records across the whole run. The default (20) keeps a trial run small and cheap; set 0 for no limit (full coverage of every selected state, which can be thousands of records per state). ## `proxy` (type: `object`): Connection settings. This source applies edge filtering that rejects datacenter ranges, so Apify Proxy with the RESIDENTIAL group (the default) is required for reliable results. ## `maxResidentialMB` (type: `integer`): Optional cap on residential traffic. After this many MB, the run stops to avoid extra premium traffic. 0 means no budget cap. ## `mcpConnectors` (type: `array`): Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com). ## `notionParentPageUrl` (type: `string`): URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors. ## `maxNotifyListings` (type: `integer`): Cap on items written to each connector per run. Does not affect the dataset. ## Actor input object example ```json { "mode": "search", "states": [ "Florida" ], "includeCommunities": true, "includeHomesites": true, "enrichDetails": false, "startUrls": [ "https://www.lennar.com/new-homes/florida" ], "maxItems": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] }, "maxResidentialMB": 0, "maxNotifyListings": 50 } ``` # 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "mode": "search", "states": [ "Florida" ], "startUrls": [ "https://www.lennar.com/new-homes/florida" ], "maxItems": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "mode": "search", "states": ["Florida"], "startUrls": ["https://www.lennar.com/new-homes/florida"], "maxItems": 20, "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/lennar-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 '{ "mode": "search", "states": [ "Florida" ], "startUrls": [ "https://www.lennar.com/new-homes/florida" ], "maxItems": 20, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call abotapi/lennar-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/lennar-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Lennar Homes, Communities & Floor Plans Scraper", "description": "Scrape Lennar new-home communities, move-in-ready homes and floor plans. Extract prices, monthly payment breakdowns, price drops, beds, baths, square footage, coordinates, amenities, virtual tours and 50+ fields. Search by state or paste Lennar URLs.", "version": "1.0", "x-build-id": "Zybg1118PZcGxf5Bq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~lennar-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-lennar-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/abotapi~lennar-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-lennar-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/abotapi~lennar-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-lennar-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", "required": [ "mode" ], "properties": { "mode": { "title": "Search mode", "enum": [ "search", "url" ], "type": "string", "description": "How to choose what to scrape. 'search' iterates the states you pick; 'url' scrapes specific lennar.com/new-homes pages you paste (a state landing page, or a community page for its floor plans).", "default": "search" }, "states": { "title": "States", "type": "array", "description": "One or more US states to scrape. Each state returns every community and move-in-ready home Lennar lists there. Only applies in 'search' mode.", "items": { "type": "string", "enum": [ "Alabama", "Arizona", "Arkansas", "California", "Colorado", "Delaware", "Florida", "Georgia", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Maryland", "Minnesota", "Missouri", "Nebraska", "Nevada", "New Jersey", "New York", "North Carolina", "Oklahoma", "Oregon", "Pennsylvania", "South Carolina", "Tennessee", "Texas", "Utah", "Virginia", "Washington", "West Virginia", "Wisconsin" ] }, "default": [ "Florida" ] }, "includeCommunities": { "title": "Include communities", "type": "boolean", "description": "Output one record per community / master-planned community with price, bed, bath, sqft ranges, badge, brand, status, and coordinates.", "default": true }, "includeHomesites": { "title": "Include move-in-ready homes", "type": "boolean", "description": "Output one record per available home with a firm price, full estimated monthly payment breakdown (principal & interest, taxes, insurance, HOA), beds, baths, square footage, plan, and status.", "default": true }, "enrichDetails": { "title": "Include floor plans (detail crawl)", "type": "boolean", "description": "Output one record per floor plan offered in each community (plan name, specs, elevation images, virtual tour, walkthrough) plus community amenities, sales consultants, and reviews. This fetches one extra page per community, so it is slower and billed separately. Leave off for the fast, cheap community + home overview.", "default": false }, "startUrls": { "title": "URLs", "type": "array", "description": "lennar.com URLs to scrape: a state page (lennar.com/new-homes/florida) collects that whole state; a community page (lennar.com/new-homes/florida/.../angeline) returns its floor plans and community detail. Only applies in 'url' mode.", "items": { "type": "string" } }, "maxItems": { "title": "Max records", "minimum": 0, "type": "integer", "description": "Stop after this many records across the whole run. The default (20) keeps a trial run small and cheap; set 0 for no limit (full coverage of every selected state, which can be thousands of records per state).", "default": 20 }, "proxy": { "title": "Proxy", "type": "object", "description": "Connection settings. This source applies edge filtering that rejects datacenter ranges, so Apify Proxy with the RESIDENTIAL group (the default) is required for reliable results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }, "maxResidentialMB": { "title": "Residential traffic budget (MB)", "minimum": 0, "type": "integer", "description": "Optional cap on residential traffic. After this many MB, the run stops to avoid extra premium traffic. 0 means no budget cap.", "default": 0 }, "mcpConnectors": { "title": "Pipe results into your apps (optional)", "type": "array", "description": "Optionally send the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. Authorize a connector once under Apify → Settings → Integrations, then select it here. The connector receives a condensed, human-readable summary per item (title + key fields), not the full JSON — the complete record stays in the dataset. Leave empty to skip. Supported: Notion (https://mcp.notion.com/mcp), Linear (https://mcp.linear.app/sse), Airtable (https://mcp.airtable.com/mcp), Apify (https://mcp.apify.com)." }, "notionParentPageUrl": { "title": "Notion parent page (Notion connector only)", "type": "string", "description": "URL (or id) of the Notion page under which item pages are created. Required to enable the Notion export; ignored by other connectors." }, "maxNotifyListings": { "title": "Max items to export per connector", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Cap on items written to each connector per run. Does not affect the dataset.", "default": 50 } } }, "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 } } } } } } } } } } ```