# DR Horton $1πŸ’° New Homes, Communities & Move-In Listings (`abotapi/drhorton-scraper`) Actor From $1/1K. Extract new-home data from drhorton.com, America’s largest homebuilder. Pull communities and quick move-in homes by state with prices, payment estimates, floor plans, square footage, amenities, and map coordinates. - **URL**: https://apify.com/abotapi/drhorton-scraper.md - **Developed by:** [AbotAPI](https://apify.com/abotapi) (community) - **Categories:** Real estate, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing from $1.00 / 1,000 result items 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 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 ## D.R. Horton Scraper Extract new-home data from drhorton.com, America's largest homebuilder, at scale. This actor pulls entire states of communities and quick move-in homes in seconds, with firm prices, monthly payment estimates, floor plans, square footage, amenities, and map coordinates. ### Why this scraper? - **Three record types, one run:** communities (neighbourhood summaries), quick move-in homes (move-in-ready homes with firm prices), and floor plans (model name, code, specs). - **Whole states in two requests:** one state returns every community and every move-in home D.R. Horton lists there, hundreds of records, in two calls. - **40+ fields per record**, including monthly payment estimates, original vs current price (so you can spot price drops), lot numbers, plan codes, and GPS coordinates. - **Datacenter-friendly:** the data source returns full results over datacenter connections, so you do not pay for premium residential traffic. Residential remains available as an option. - **Search or URL mode:** pick states from a list, or paste any drhorton.com state, market, city, or community page. - **Built-in cost controls:** a residential traffic budget with automatic downgrade to datacenter, plus a hard record cap. - **Resilient:** automatic retries, connection rotation, health monitoring, and a backup connection gateway for failover. ### Data you get > Sample shape, values are illustrative placeholders, not from a live listing. #### Community record | Field | Example | | --- | --- | | recordType | community | | communityName | Sample Community | | brand | Express Series | | propertyType | Single family | | address | Sample City, ST 00000 | | url | https://www.drhorton.com/state/market/city/sample-community | | imageUrl | https://www.drhorton.com/-/media/.../000000000.jpg | | sellingStatus | Now Selling | | availableHomes | 6 | | latitude / longitude | 33.0000 / -87.0000 | | minBeds / maxBeds | 3 / 4 | | minBaths / maxBaths | 2 / 2.5 | | minSqft / maxSqft | 1272 / 2164 | | minPrice / maxPrice | 244400 / 294900 | | amenities | ["Granite Countertops", "HOA"] | #### Quick move-in home record | Field | Example | | --- | --- | | recordType | home | | address | 100 Sample Drive | | price | 347900 | | originalPrice | 355900 | | monthlyPayment | 1964.52 | | bedrooms / bathrooms / garages | 4 / 3 / 3 | | sqft | 2273 | | lot | 0000 | | series | Tradition Series | | city / market | Sample City / Sample Market | | latitude / longitude | 33.0000 / -87.0000 | | pending / underContract / sold | false / false / false | | url | https://www.drhorton.com/state/market/city/community/qmis/100-sample-drive | #### Floor plan record | Field | Example | | --- | --- | | recordType | plan | | planName | The Sample | | planCode | SMPL | | brandName | Express Series | | sqft | 1618 | | bedrooms / bathrooms / garages | 3 / 2 / 2 | | price | 269900 | | status | Available | | communityPhone | 000-000-0000 | | communityHours | [{"dayOfWeek": "Monday", "opens": "10:00", "closes": "18:00"}] | | url | https://www.drhorton.com/state/market/city/community/floor-plans/smpl | Floor plan records also include `communityAddressDetail` (full postal address) and `communityHours` (sales office opening hours), pulled from the community page during the detail crawl. Every record also includes a `raw` object with all original source fields, so no field is ever lost. ### How to use **Scrape one state (communities + move-in homes):** ```json { "mode": "search", "states": ["Texas"], "includeCommunities": true, "includeQmiHomes": true, "proxy": { "useApifyProxy": true } } ```` **Scrape several states, move-in homes only:** ```json { "mode": "search", "states": ["Florida", "Georgia", "South Carolina"], "includeCommunities": false, "includeQmiHomes": true, "proxy": { "useApifyProxy": true } } ``` **Add floor plans (detail crawl):** ```json { "mode": "search", "states": ["Arizona"], "includeFloorPlans": true, "proxy": { "useApifyProxy": true } } ``` **Scrape specific pages (URL mode):** ```json { "mode": "url", "startUrls": [ "https://www.drhorton.com/texas/dallas", "https://www.drhorton.com/florida" ], "proxy": { "useApifyProxy": true } } ``` ### Input parameters | Parameter | Type | Default | Description | | --- | --- | --- | --- | | mode | string | search | "search" iterates states; "url" scrapes pasted URLs. | | states | array | \["Texas"] | States to scrape in search mode. | | includeCommunities | boolean | true | Output one record per community. | | includeQmiHomes | boolean | true | Output one record per quick move-in home. | | includeFloorPlans | boolean | false | Output one record per floor plan (fetches one extra page per community; billed separately). | | startUrls | array | - | drhorton.com state, market, city, or community URLs (url mode). | | maxItems | integer | 20 | Stop after this many records. The default keeps a trial run small; set 0 for no limit (hundreds of records per state). | | proxy | object | Apify datacenter | Connection settings. Datacenter is the cheapest reliable option here. | | maxResidentialMB | integer | 0 | Residential traffic budget in MB; after the cap the run auto-downgrades to datacenter. 0 means no cap. | ### Send results into your apps (MCP connectors) Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step **after** the scrape β€” the Apify dataset is never changed. **What gets written to the connector:** a condensed, human-readable **summary** of each record β€” not the full JSON. Each item becomes one entry with a **title** and its key fields flattened to plain text. The **complete record always stays in the Apify dataset**. 1. Authorize a connector once under **Apify β†’ Settings β†’ Integrations** (Notion, Linear, Airtable, or Apify). 2. Select it in the **"Pipe results into your apps"** input field. (If the picker is empty, you haven't authorized a connector yet.) 3. For **Notion**, also set `notionParentPageUrl` to the page where items should be created. The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip. ### Output example > Sample shape, values are illustrative placeholders. ```json { "recordType": "home", "id": "home:/state/market/city/community/qmis/100-sample-drive", "state": "Texas", "address": "100 Sample Drive", "lot": "0000", "url": "https://www.drhorton.com/state/market/city/community/qmis/100-sample-drive", "communityName": "Sample Community", "communityUrl": "https://www.drhorton.com/state/market/city/community", "price": 347900, "originalPrice": 355900, "monthlyPayment": 1964.52, "bedrooms": 4, "bathrooms": 3, "garages": 3, "stories": 1, "sqft": 2273, "propertyType": "Single Family", "series": "Tradition Series", "city": "Sample City", "market": "Sample Market", "latitude": 33.0000, "longitude": -87.0000, "pending": false, "underContract": false, "sold": false } ``` ### Plan requirement This actor runs on Apify datacenter connections by default, which work on every plan including the Free tier. Residential connections are optional and only needed if datacenter is ever blocked; they require a Starter plan or higher. For the lowest cost, keep the default datacenter setting and leave the residential traffic budget at 0. # Actor input Schema ## `mode` (type: `string`): How to choose what to scrape. 'search' iterates the states you pick; 'url' scrapes specific drhorton.com state, market, city, or community pages you paste. ## `states` (type: `array`): One or more US states to scrape. Each state returns every community and quick move-in home D.R. Horton lists there. Only applies in 'search' mode. ## `includeCommunities` (type: `boolean`): Output one record per community (neighbourhood) with price, bed, bath, sqft ranges, amenities, brand, status, and coordinates. ## `includeQmiHomes` (type: `boolean`): Output one record per move-in-ready home with a firm price, monthly payment estimate, exact address, lot, beds, baths, and status. ## `includeFloorPlans` (type: `boolean`): Output one record per floor plan offered in each community (plan name, plan code, square footage, beds, baths, price). 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`): drhorton.com URLs to scrape: a state page (drhorton.com/texas), a market or city page (drhorton.com/texas/dallas), or a community page (returns its floor plans). Multiple URLs supported. 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 hundreds of records per state). ## `proxy` (type: `object`): Connection settings. The data source returns full results over Apify datacenter, so datacenter (the default) is the cheapest reliable option. Residential is optional and only needed if datacenter is ever blocked. ## `maxResidentialMB` (type: `integer`): Only applies when the proxy group is RESIDENTIAL. After this many MB of residential traffic, the run auto-downgrades to the cheaper datacenter tier (which serves identical data). 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": [ "Texas" ], "includeCommunities": true, "includeQmiHomes": true, "includeFloorPlans": false, "startUrls": [ "https://www.drhorton.com/texas/dallas" ], "maxItems": 20, "proxy": { "useApifyProxy": true }, "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 = { "states": [ "Texas" ], "startUrls": [ "https://www.drhorton.com/texas/dallas" ], "maxItems": 20, "proxy": { "useApifyProxy": true } }; // Run the Actor and wait for it to finish const run = await client.actor("abotapi/drhorton-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 = { "states": ["Texas"], "startUrls": ["https://www.drhorton.com/texas/dallas"], "maxItems": 20, "proxy": { "useApifyProxy": True }, } # Run the Actor and wait for it to finish run = client.actor("abotapi/drhorton-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 '{ "states": [ "Texas" ], "startUrls": [ "https://www.drhorton.com/texas/dallas" ], "maxItems": 20, "proxy": { "useApifyProxy": true } }' | apify call abotapi/drhorton-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=abotapi/drhorton-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "DR Horton $1πŸ’° New Homes, Communities & Move-In Listings", "description": "From $1/1K. Extract new-home data from drhorton.com, America’s largest homebuilder. Pull communities and quick move-in homes by state with prices, payment estimates, floor plans, square footage, amenities, and map coordinates.", "version": "1.0", "x-build-id": "Sk9VvBmFeug6DEboV" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/abotapi~drhorton-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-abotapi-drhorton-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~drhorton-scraper/runs": { "post": { "operationId": "runs-sync-abotapi-drhorton-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~drhorton-scraper/run-sync": { "post": { "operationId": "run-sync-abotapi-drhorton-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 drhorton.com state, market, city, or community pages you paste.", "default": "search" }, "states": { "title": "States", "type": "array", "description": "One or more US states to scrape. Each state returns every community and quick move-in home D.R. Horton lists there. Only applies in 'search' mode.", "items": { "type": "string", "enum": [ "Alabama", "Alaska", "Arizona", "Arkansas", "California", "Colorado", "Connecticut", "Delaware", "Florida", "Georgia", "Hawaii", "Idaho", "Illinois", "Indiana", "Iowa", "Kansas", "Kentucky", "Louisiana", "Maine", "Maryland", "Massachusetts", "Michigan", "Minnesota", "Mississippi", "Missouri", "Montana", "Nebraska", "Nevada", "New Hampshire", "New Jersey", "New Mexico", "New York", "North Carolina", "North Dakota", "Ohio", "Oklahoma", "Oregon", "Pennsylvania", "Rhode Island", "South Carolina", "South Dakota", "Tennessee", "Texas", "Utah", "Vermont", "Virginia", "Washington", "West Virginia", "Wisconsin", "Wyoming" ] }, "default": [ "Texas" ] }, "includeCommunities": { "title": "Include communities", "type": "boolean", "description": "Output one record per community (neighbourhood) with price, bed, bath, sqft ranges, amenities, brand, status, and coordinates.", "default": true }, "includeQmiHomes": { "title": "Include quick move-in homes", "type": "boolean", "description": "Output one record per move-in-ready home with a firm price, monthly payment estimate, exact address, lot, beds, baths, and status.", "default": true }, "includeFloorPlans": { "title": "Include floor plans (detail crawl)", "type": "boolean", "description": "Output one record per floor plan offered in each community (plan name, plan code, square footage, beds, baths, price). 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": "drhorton.com URLs to scrape: a state page (drhorton.com/texas), a market or city page (drhorton.com/texas/dallas), or a community page (returns its floor plans). Multiple URLs supported. 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 hundreds of records per state).", "default": 20 }, "proxy": { "title": "Proxy", "type": "object", "description": "Connection settings. The data source returns full results over Apify datacenter, so datacenter (the default) is the cheapest reliable option. Residential is optional and only needed if datacenter is ever blocked.", "default": { "useApifyProxy": true } }, "maxResidentialMB": { "title": "Residential traffic budget (MB)", "minimum": 0, "type": "integer", "description": "Only applies when the proxy group is RESIDENTIAL. After this many MB of residential traffic, the run auto-downgrades to the cheaper datacenter tier (which serves identical data). 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 } } } } } } } } } } ```