# HUD Homes Scraper (`crawlerbros/hud-homes-scraper`) Actor Scrape HUD foreclosed homes listings from HUDHomeStore.gov with search by state or city, filter by price, bedrooms, bathrooms, property type. Returns full listing data including address, price, beds/baths, sqft, images, and bid dates. - **URL**: https://apify.com/crawlerbros/hud-homes-scraper.md - **Developed by:** [Crawler Bros](https://apify.com/crawlerbros) (community) - **Categories:** Real estate, Developer tools, Automation - **Stats:** 1 total users, 0 monthly users, 100.0% runs succeeded, 4 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $3.00 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 ## HUD Homes Scraper Scrape U.S. Department of Housing and Urban Development (HUD) foreclosed home listings from [HUDHomeStore.gov](https://www.hudhomestore.gov) — the official government marketplace for HUD-owned properties. Search by state, city, ZIP code, or address, and filter by price, bedrooms, bathrooms, property type, and FHA financing status. ### What is a HUD Home? A HUD home is a 1-to-4 unit residential property acquired by HUD as a result of a foreclosure action on an FHA-insured mortgage. HUD becomes the property owner and offers it for sale to recover the loss on the foreclosure claim. These properties are typically sold at competitive prices and may be eligible for special financing programs. ### Features - **Search by location** — state abbreviation (TX), city + state (Houston, TX), ZIP code (77406), or full address - **Full listing data** — address, price, bedrooms, bathrooms, square footage, year built, property type, county - **Bid information** — bid open date, listing period deadline, eligible bidder types - **Financing details** — FHA financing type (Insured, Insured Escrow, Uninsured), 100% Down Program eligibility - **Property amenities** — indoor and outdoor amenity lists - **Images** — high-quality Cloudinary-hosted property photos - **GPS coordinates** — latitude and longitude for map integration - **Filter options** — price range, bedrooms, bathrooms, property type, status, FHA financing ### Input | Field | Type | Description | |---|---|---| | `location` | String | **Required.** State abbrev (TX), city+state (Houston, TX), ZIP (77406), or address | | `priceMin` | Integer | Minimum listing price in USD | | `priceMax` | Integer | Maximum listing price in USD | | `bedroomsMin` | Integer | Minimum number of bedrooms | | `bedroomsMax` | Integer | Maximum number of bedrooms | | `bathroomsMin` | Number | Minimum number of bathrooms | | `propertyType` | Select | Filter by type: Single Family Home, Condo, Manufactured Home | | `propertyStatus` | Select | Filter by status: New Listing, Price Reduced, Vacant Lot Commission | | `fhaFinancing` | Select | Filter by FHA type: Insured (IN), Insured Escrow (IE), Uninsured (UI) | | `maxItems` | Integer | Maximum number of results (default: 100, max: 5000) | #### Example Input ```json { "location": "TX", "priceMin": 100000, "priceMax": 400000, "bedroomsMin": 3, "propertyType": "Single Family Home", "maxItems": 50 } ```` ### Output Each record contains: | Field | Type | Description | |---|---|---| | `caseNumber` | String | HUD case number (e.g. 512-510068) | | `address` | String | Street address | | `city` | String | City | | `state` | String | State abbreviation | | `zip` | String | ZIP code | | `county` | String | County name | | `price` | Integer | Listing price in USD | | `bedrooms` | Integer | Number of bedrooms | | `bathrooms` | Number | Number of bathrooms (may be decimal, e.g. 3.1) | | `squareFootage` | Integer | Square footage | | `yearBuilt` | Integer | Year built | | `propertyType` | String | Single Family Home, Condo, or Manufactured Home | | `status` | String | New Listing, Price Reduced, or Vacant Lot Commission | | `fhaFinancing` | String | IN (Insured), IE (Insured Escrow), UI (Uninsured) | | `listingPeriod` | String | Listing period type (e.g. Extended, Owner Occupant) | | `parkingType` | String | Parking type (e.g. Garage, Carport) | | `numberOfStories` | Number | Number of stories | | `indoorAmenities` | Array | Indoor amenities (e.g. Fireplace, Central Air) | | `outdoorAmenities` | Array | Outdoor amenities (e.g. Pool/Spa, Patio/Deck, Fence) | | `listDate` | String | Date listed (MM/DD/YYYY) | | `bidOpenDate` | String | Date bidding opens (MM/DD/YYYY) | | `periodDeadlineDate` | String | Deadline date for current listing period | | `eligibleBidders` | Array | Who can bid (Owner Occupant, Investor, Nonprofit, Government Agency) | | `eligibleBiddersLabel` | String | Eligible bidder description (e.g. All Bidders) | | `program100Down` | Boolean | True if eligible for 100% Down Payment Program | | `latitude` | Number | GPS latitude | | `longitude` | Number | GPS longitude | | `imageUrl` | String | Primary property image URL | | `imageUrls` | Array | All property image URLs | | `url` | String | HUD listing detail URL | #### Example Output Record ```json { "caseNumber": "512-510068", "address": "2206 Spanish Forest Ln", "city": "Richmond", "state": "TX", "zip": "77406", "county": "Fort Bend", "price": 561200, "bedrooms": 5, "bathrooms": 3.1, "squareFootage": 4482, "yearBuilt": 1995, "propertyType": "Single Family Home", "status": "Price Reduced", "fhaFinancing": "IN (Insured)", "listingPeriod": "Extended", "parkingType": "Garage", "numberOfStories": 2.0, "indoorAmenities": ["Fireplace"], "outdoorAmenities": ["Patio/Deck", "Pool/Spa", "Porch", "Fence"], "listDate": "05/19/2026", "bidOpenDate": "05/26/2026", "periodDeadlineDate": "09/28/2026", "eligibleBidders": ["Investor", "Owner Occupant", "Nonprofit", "Government Agency"], "eligibleBiddersLabel": "All Bidders", "program100Down": true, "latitude": 29.6375, "longitude": -95.7414, "imageUrl": "https://res.cloudinary.com/yardi/image/upload/q_auto,f_auto,c_limit,w_600/.../hhs/Front_73676887.png", "imageUrls": ["...Front.png", "...Back.png", "...Bath.png"], "url": "https://www.hudhomestore.gov/listing/512-510068" } ``` ### Data Source Data is sourced directly from [HUDHomeStore.gov](https://www.hudhomestore.gov), the official U.S. Department of Housing and Urban Development marketplace for foreclosed homes. This is a government website and is freely accessible without authentication. No proxy or paid APIs are required. ### FAQs **Q: What is a HUD foreclosure home?** A: When a homeowner with an FHA-insured loan defaults, HUD pays the lender's claim and takes ownership of the property. HUD then sells these homes at market value through registered brokers. **Q: Do I need a broker to buy a HUD home?** A: Yes, bids must be submitted by a HUD-registered selling broker or buyer's agent. This scraper provides listing data; purchasing requires engaging a HUD-registered broker. **Q: How current is the data?** A: Data is pulled directly from HUDHomeStore.gov in real-time each time the actor runs, reflecting the current live inventory. **Q: What states have HUD homes?** A: HUD homes are available in all 50 U.S. states. Texas, Florida, California, and Ohio typically have the most listings. Search by state abbreviation (TX, FL, CA, etc.) for all listings in that state. **Q: What is the 100% Down Payment Program?** A: The $100 Down Payment Incentive allows qualified owner-occupant buyers to purchase an eligible HUD home with a minimum down payment of just $100 when using FHA financing. **Q: Are photos available?** A: Yes, when available, listing photos are included via Cloudinary-hosted URLs accessible without authentication. **Q: How do I filter by county?** A: Currently the actor searches by state or city. The `county` field is included in output — you can post-filter results programmatically. # Actor input Schema ## `location` (type: `string`): State abbreviation (e.g. TX), city + state (e.g. Houston, TX), ZIP code (e.g. 77406), or street address. Required. ## `priceMin` (type: `integer`): Only include listings at or above this price. ## `priceMax` (type: `integer`): Only include listings at or below this price. ## `bedroomsMin` (type: `integer`): Only include listings with at least this many bedrooms. ## `bedroomsMax` (type: `integer`): Only include listings with at most this many bedrooms. ## `bathroomsMin` (type: `number`): Only include listings with at least this many bathrooms. ## `propertyType` (type: `string`): Filter to a specific property type. ## `propertyStatus` (type: `string`): Filter by listing status. ## `fhaFinancing` (type: `string`): Filter by FHA financing type. ## `maxItems` (type: `integer`): Maximum number of listings to return. ## Actor input object example ```json { "location": "TX", "propertyType": "", "propertyStatus": "", "fhaFinancing": "", "maxItems": 100 } ``` # Actor output Schema ## `homes` (type: `string`): Dataset containing all scraped HUD home listings. # 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 = { "location": "TX", "propertyType": "", "propertyStatus": "", "fhaFinancing": "", "maxItems": 100 }; // Run the Actor and wait for it to finish const run = await client.actor("crawlerbros/hud-homes-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 = { "location": "TX", "propertyType": "", "propertyStatus": "", "fhaFinancing": "", "maxItems": 100, } # Run the Actor and wait for it to finish run = client.actor("crawlerbros/hud-homes-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 '{ "location": "TX", "propertyType": "", "propertyStatus": "", "fhaFinancing": "", "maxItems": 100 }' | apify call crawlerbros/hud-homes-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=crawlerbros/hud-homes-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HUD Homes Scraper", "description": "Scrape HUD foreclosed homes listings from HUDHomeStore.gov with search by state or city, filter by price, bedrooms, bathrooms, property type. Returns full listing data including address, price, beds/baths, sqft, images, and bid dates.", "version": "1.0", "x-build-id": "MEMhe2VYdUkTgWBxG" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawlerbros~hud-homes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawlerbros-hud-homes-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/crawlerbros~hud-homes-scraper/runs": { "post": { "operationId": "runs-sync-crawlerbros-hud-homes-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/crawlerbros~hud-homes-scraper/run-sync": { "post": { "operationId": "run-sync-crawlerbros-hud-homes-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": [ "location" ], "properties": { "location": { "title": "Location (State, City, ZIP, or Address)", "type": "string", "description": "State abbreviation (e.g. TX), city + state (e.g. Houston, TX), ZIP code (e.g. 77406), or street address. Required.", "default": "TX" }, "priceMin": { "title": "Minimum price ($)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Only include listings at or above this price." }, "priceMax": { "title": "Maximum price ($)", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Only include listings at or below this price." }, "bedroomsMin": { "title": "Minimum bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Only include listings with at least this many bedrooms." }, "bedroomsMax": { "title": "Maximum bedrooms", "minimum": 0, "maximum": 20, "type": "integer", "description": "Only include listings with at most this many bedrooms." }, "bathroomsMin": { "title": "Minimum bathrooms", "minimum": 0, "maximum": 20, "type": "number", "description": "Only include listings with at least this many bathrooms." }, "propertyType": { "title": "Property type", "enum": [ "", "Single Family Home", "Condo", "Manufactured Home" ], "type": "string", "description": "Filter to a specific property type.", "default": "" }, "propertyStatus": { "title": "Listing status", "enum": [ "", "New Listing", "Price Reduced", "Vacant Lot Commission" ], "type": "string", "description": "Filter by listing status.", "default": "" }, "fhaFinancing": { "title": "FHA Financing", "enum": [ "", "IN (Insured)", "IE (Insured Escrow)", "UI (Uninsured)" ], "type": "string", "description": "Filter by FHA financing type.", "default": "" }, "maxItems": { "title": "Max items", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Maximum number of listings to return.", "default": 100 } } }, "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 } } } } } } } } } } ```