# HUD Assisted Multifamily Housing Scraper - Section 8 (`oriented_wallpaper/hud-assisted-housing-scraper`) Actor Scrape HUD assisted multifamily housing (Section 8/202/811) from the official HUD ArcGIS — property, units, mgmt contact (name, phone, email), program, REAC score & subsidy contract-expiration dates. Filter by state/program + expiring-within-months. No API key. Export CSV/JSON. - **URL**: https://apify.com/oriented\_wallpaper/hud-assisted-housing-scraper.md - **Developed by:** [Flash Scrape](https://apify.com/oriented_wallpaper) (community) - **Categories:** Real estate, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $5.00 / 1,000 results This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. 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 Assisted Multifamily Housing Scraper - Section 8 **This HUD scraper turns the official HUD assisted-housing database into clean, contactable leads with a built-in deal trigger** — every Section 8 (project-based), 202 (elderly), 811 (disabled), PRAC, and RAP property in the US. Each row gives the property, address, units, the **management contact (name, phone, email)**, the program(s), the REAC inspection score, troubled/watch-list flags, and — the killer field — the **subsidy contract expiration date**. Filter by state, program, units, or **contracts expiring within N months**, and export to CSV, JSON, or Excel. Built for **affordable-housing acquirers & syndicators, LIHTC investors, property managers, PACE/retrofit & agency lenders, and B2B vendors** who need both contactable owners *and* an early signal on which subsidies are about to expire (the acquisition/preservation trigger). Official government data, **no API key, no anti-bot.** --- ### Why this beats a generic property list - **0-100 `deal_score`** — the headline field rivals don't have: an explainable acquisition/distress score combining expiration urgency, distress (troubled / in-default / watch-list), value-add condition (low REAC), maturing debt, and lease-up upside — with a `deal_score_breakdown` so you see exactly why. Filter with `minDealScore`. - **Contactable** — the management agent's **email + phone** plus the **project manager** name come straight from HUD, so leads are reachable. - **The deal trigger** — `next_expiration` + the "expiring within N months" filter surface properties whose subsidy contract is about to roll, which is exactly when acquisition/preservation deals happen. - **Financing & distress depth** — FHA loan number, **original loan amount, loan maturity date, debt-service-coverage ratio**, in-default / HUD-held / HUD-owned flags, OPIIS risk score — the underwriting signals others omit. - **Occupancy, rent & demographics** — `pct_occupied`, `rent_per_month`, rent-to-FMR ratio, tenant income, and the resident profile (elderly, disabled, minority, female-headed, bedroom mix). - **All program subsidies decoded** — a `programs_detail` list (Section 8, 202/811, PRAC, PAC, RAD, BMIR, 236…) instead of two raw codes, plus metro/county/congressional-district geo. - **Clean** — HUD's source has 284 columns of nested junk; this returns ~60 useful, flat, labeled fields. - **Authoritative + free** — official HUD ArcGIS open data, no key, no proxies. #### Input | Field | Type | Description | |---|---|---| | `state` | string | Two-letter state code (e.g. `CA`). Blank = nationwide. | | `city` | string | City (prefix match, optional). | | `program` | string | All / Section 8 / 202 & 811. | | `expiringWithinMonths` | integer | **Deal trigger:** only contracts expiring within N months (`0` = off). | | `minUnits` | integer | Minimum total units. | | `onlyWithContact` | boolean | Only properties with a management email/phone. | | `troubledOnly` | boolean | Only troubled / watch-list properties. | | `inDefaultOnly` | boolean | Only properties whose HUD loan is in default/delinquent. | | `maxOccupancy` | integer | Only properties at/below this occupancy % (lease-up upside). | | `minDealScore` | integer | Only properties with `deal_score` ≥ this (0-100). | | `maxItems` | integer | Max properties. Default `500`. | **Example input:** ```json { "state": "CA", "program": "section8", "expiringWithinMonths": 18, "onlyWithContact": true, "maxItems": 1000 } ```` #### JSON output sample ```json { "property_id": "800012345", "property_name": "Capitol Oaks Senior Residences", "address": "1374 Murphy Ave SW", "city": "Atlanta", "state": "GA", "zip": "30310", "latitude": 33.72, "longitude": -84.41, "metro_area": "Atlanta-Sandy Springs-Alpharetta, GA", "congressional_district": "5", "deal_score": 73, "deal_score_breakdown": { "expiration_urgency": 30, "distress": 18, "condition": 15, "loan_maturity": 10, "occupancy": 0 }, "total_units": 120, "assisted_units": 120, "programs": ["202/8 NC"], "programs_detail": ["Section 8 (project-based)", "Section 202/811"], "contracts": ["GA16M000123"], "contract_expirations": ["2027-01-31"], "next_expiration": "2027-01-31", "mgmt_agent": "Mercy Housing Management", "mgmt_contact": "S. West", "mgmt_phone": "303-830-3360", "mgmt_email": "swest@mercyhousing.org", "project_manager": "A. Jones", "reac_score": 58, "risk_category": "Elevated", "troubled": true, "in_default": false, "fha_number": "061-11234", "original_loan_amount": 8200000.0, "loan_maturity_date": "2028-09-01", "debt_service_coverage_ratio": 1.12, "pct_occupied": 82.5, "rent_per_month": 1015.0, "avg_tenant_income": 14200.0, "pct_elderly_62plus": 88.0, "pct_disabled": 9.0, "is_section8": true, "hud_hub": "Atlanta" } ``` Results render as a clean, sortable table (soonest-expiring first) and export to CSV, JSON, or Excel. *** ### Use cases - **Acquisition / preservation sourcing** — find subsidized properties with contracts expiring in the next 12–24 months *before* brokers list them. - **LIHTC / affordable-housing investors** — build a target list by state with owner contacts. - **PACE / retrofit / green lenders & vendors** — reach management agents directly. - **Distressed-asset targeting** — filter to troubled / watch-list properties. *** ### Use with AI agents & automation Run from the Apify **MCP** server so AI agents can pull properties as a tool call, schedule it via **Make**, **n8n**, or **Zapier** to alert on newly-expiring contracts, or sync to **Google Sheets**. Clean flat JSON drops into a CRM with no glue code. *** ### Pricing **Pay-per-event — charged per property delivered.** Source is the free public HUD ArcGIS service (no proxy cost). See the Apify Store page for the current price. *** ### FAQ **Where's the data from?** HUD's official **Multifamily Properties – Assisted** ArcGIS open-data service — public government data. **Do I need an API key?** No. **What's `next_expiration`?** The earliest subsidy (HAP) contract expiration date on the property — the signal acquisition/preservation buyers track. Use `expiringWithinMonths` to filter to the window you care about. **Is the email reliable?** It's the management contact HUD has on file; coverage is high but not 100%. Use `onlyWithContact` to keep only reachable properties. **Can I export to CSV or Google Sheets?** Yes — CSV, JSON, or Excel from the Output tab, or sync via Make/n8n/Zapier. *** ### Other Flash Scrape scrapers - [NPI Healthcare Provider Scraper](https://apify.com/oriented_wallpaper/npi-healthcare-leads) — US provider leads - [Google Maps Leads Scraper](https://apify.com/oriented_wallpaper/google-maps-leads-opener) — local business leads - [FDA Recall Scraper](https://apify.com/oriented_wallpaper/fda-recall-scraper) — drug/device/food recalls - [Yelp Leads Scraper](https://apify.com/oriented_wallpaper/yelp-leads-scraper) — business leads + email # Actor input Schema ## `state` (type: `string`): Two-letter US state code, e.g. 'CA', 'TX', 'NY'. Leave empty for nationwide. ## `city` (type: `string`): City name (optional, prefix match). ## `program` (type: `string`): Filter by subsidy program. ## `expiringWithinMonths` (type: `integer`): The deal-trigger: keep only properties whose subsidy contract expires within this many months (0 = no filter). Expiring contracts = acquisition/preservation opportunities. ## `minUnits` (type: `integer`): Keep only properties with at least this many total units (0 = no filter). ## `onlyWithContact` (type: `boolean`): Keep only properties with a management email or phone. ## `troubledOnly` (type: `boolean`): Keep only properties flagged troubled (distressed-asset targeting). ## `inDefaultOnly` (type: `boolean`): Keep only properties whose HUD loan is in default or delinquent (deepest-distress targeting). ## `maxOccupancy` (type: `integer`): Keep only properties at or below this occupancy percentage (lease-up / value-add upside). Empty = no filter. ## `minDealScore` (type: `integer`): Keep only properties with a computed acquisition/distress deal score (0-100) at or above this. 0 = no filter. ## `maxItems` (type: `integer`): Maximum properties to return. ## Actor input object example ```json { "state": "CA", "program": "all", "expiringWithinMonths": 0, "minUnits": 0, "onlyWithContact": false, "troubledOnly": false, "inDefaultOnly": false, "minDealScore": 0, "maxItems": 500 } ``` # Actor output Schema ## `results` (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 = { "state": "CA" }; // Run the Actor and wait for it to finish const run = await client.actor("oriented_wallpaper/hud-assisted-housing-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 = { "state": "CA" } # Run the Actor and wait for it to finish run = client.actor("oriented_wallpaper/hud-assisted-housing-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 '{ "state": "CA" }' | apify call oriented_wallpaper/hud-assisted-housing-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=oriented_wallpaper/hud-assisted-housing-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HUD Assisted Multifamily Housing Scraper - Section 8", "description": "Scrape HUD assisted multifamily housing (Section 8/202/811) from the official HUD ArcGIS — property, units, mgmt contact (name, phone, email), program, REAC score & subsidy contract-expiration dates. Filter by state/program + expiring-within-months. No API key. Export CSV/JSON.", "version": "0.1", "x-build-id": "9U7bh1u4Vwn4C6EUk" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/oriented_wallpaper~hud-assisted-housing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-oriented_wallpaper-hud-assisted-housing-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/oriented_wallpaper~hud-assisted-housing-scraper/runs": { "post": { "operationId": "runs-sync-oriented_wallpaper-hud-assisted-housing-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/oriented_wallpaper~hud-assisted-housing-scraper/run-sync": { "post": { "operationId": "run-sync-oriented_wallpaper-hud-assisted-housing-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": { "state": { "title": "State", "type": "string", "description": "Two-letter US state code, e.g. 'CA', 'TX', 'NY'. Leave empty for nationwide." }, "city": { "title": "City", "type": "string", "description": "City name (optional, prefix match)." }, "program": { "title": "Program", "enum": [ "all", "section8", "202_811" ], "type": "string", "description": "Filter by subsidy program.", "default": "all" }, "expiringWithinMonths": { "title": "Contract expiring within (months)", "minimum": 0, "maximum": 120, "type": "integer", "description": "The deal-trigger: keep only properties whose subsidy contract expires within this many months (0 = no filter). Expiring contracts = acquisition/preservation opportunities.", "default": 0 }, "minUnits": { "title": "Minimum units", "minimum": 0, "type": "integer", "description": "Keep only properties with at least this many total units (0 = no filter).", "default": 0 }, "onlyWithContact": { "title": "Only with a contact", "type": "boolean", "description": "Keep only properties with a management email or phone.", "default": false }, "troubledOnly": { "title": "Troubled / watch-list only", "type": "boolean", "description": "Keep only properties flagged troubled (distressed-asset targeting).", "default": false }, "inDefaultOnly": { "title": "In default / delinquent only", "type": "boolean", "description": "Keep only properties whose HUD loan is in default or delinquent (deepest-distress targeting).", "default": false }, "maxOccupancy": { "title": "Maximum occupancy (%)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only properties at or below this occupancy percentage (lease-up / value-add upside). Empty = no filter." }, "minDealScore": { "title": "Minimum deal score", "minimum": 0, "maximum": 100, "type": "integer", "description": "Keep only properties with a computed acquisition/distress deal score (0-100) at or above this. 0 = no filter.", "default": 0 }, "maxItems": { "title": "Max properties", "minimum": 1, "maximum": 25000, "type": "integer", "description": "Maximum properties to return.", "default": 500 } } }, "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 } } } } } } } } } } ```