# HUD Assisted Multifamily Housing Scraper - Section 8 (`flash_scraper/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/flash\_scraper/hud-assisted-housing-scraper.md - **Developed by:** [Flash Scrape](https://apify.com/flash_scraper) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 3 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: 5.00 out of 5 stars ## Pricing from $0.000035 / actor start 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 ## HUD Assisted Housing Scraper — Section 8 property leads with an expiring-contract deal score **Section 8 and HUD assisted-housing property leads with a built-in deal score and an expiring-contracts filter** — the acquisition and preservation trigger that real-estate investors and PropTech teams can't get from any mainstream lead source. This actor pulls HUD's official Multifamily Assisted Properties database and turns the raw 280-column government export into contactable, scored rows: management contact (name, phone, **email**), subsidy programs, REAC inspection score, distress flags, and the **HAP contract expiration date** with a computed **0–100 `deal_score`**. Direct from HUD's open-data service — **no API key, no login, no proxies** — and **pay-per-result** at $5 per 1,000 properties. ### What it does - **Queries HUD's live ArcGIS open-data service** (Multifamily Properties – Assisted) on every run — the same feed HUD publishes for public download, covering **Section 8 (project-based)**, **202 (elderly)**, **811 (disabled)**, **PRAC**, **RAP/Rent Supplement**, **BMIR**, **236**, and RAD-conversion properties. - **Flattens ~280 government fields into ~60 clean columns** per property: identity, standardized address, coordinates, metro/county/tract context, unit counts, contract numbers, and expiration dates. - **Surfaces the outreach contact**: management agent organization, contact full name, phone, **email**, project manager, and the on-site phone — with a `has_email` flag for quick filtering. - **Computes a 0–100 `deal_score`** from expiration urgency (up to 30 pts for contracts rolling within 12 months), distress flags (troubled / in-default / watch-list / risk category, up to 35), REAC condition (up to 15), loan maturity within 36 months (10), and sub-85% occupancy (10) — with a `deal_score_breakdown` object showing exactly how each component contributed. - **Filters server- and client-side**: state, city (prefix match), program, minimum units, contact-required, troubled-only, in-default-only, max occupancy, minimum deal score, and — the headline — **contracts expiring within N months**. - **Cleans government quirks**: HUD's `-4` "not reported" sentinels become `null` instead of leaking fake negative rents into your model, and all date formats are normalized to `YYYY-MM-DD`. Results sort by soonest `next_expiration`. ### Use cases - **Affordable-housing acquirers & syndicators** — build a state list of Section 8 properties whose HAP contract expires within 18 months, the classic preservation-deal trigger, before a broker ever lists them. - **LIHTC investors** — a nationwide or state-by-state target list with real management contacts instead of weeks of county-assessor scraping. - **PropTech & data platforms** — a clean, structured HUD dataset to power underwriting tools, deal-sourcing dashboards, and market intelligence. - **PACE/retrofit and agency lenders** — reach management agents at properties with maturing debt or low REAC scores (value-add retrofit candidates). - **B2B vendors** (insurance, compliance, service coordination) — a contactable list of HUD-assisted property managers segmented by state and program. ### Input | Field | Type | Default | Description | |---|---|---|---| | `state` | string | `"CA"` | Two-letter US state code (e.g. `TX`, `NY`). Leave empty for nationwide. | | `city` | string | — | City name (optional, prefix match). | | `program` | string | `"all"` | `all`, `section8` (project-based), or `202_811` (elderly/disabled). | | `expiringWithinMonths` | integer | `0` | The deal trigger: keep only properties whose subsidy contract expires within this many months (0–120; 0 = off). | | `minUnits` | integer | `0` | Keep only properties with at least this many total units (0 = off). | | `onlyWithContact` | boolean | `false` | Keep only properties with a management email or phone. | | `troubledOnly` | boolean | `false` | Keep only properties flagged troubled (distressed-asset targeting). | | `inDefaultOnly` | boolean | `false` | Keep only properties whose HUD loan is in default/delinquent. | | `maxOccupancy` | integer | — | Keep only properties at or below this occupancy % (lease-up upside). Empty = off. | | `minDealScore` | integer | `0` | Keep only properties scoring at or above this (0–100; 0 = off). | | `maxItems` | integer | `500` | Maximum properties to return (1–25,000). | ```json { "state": "CA", "program": "section8", "expiringWithinMonths": 18, "minUnits": 50, "onlyWithContact": true, "maxItems": 1000 } ```` Every field is optional — an empty input returns a nationwide pull up to `maxItems`. ### Output One dataset row per property, sorted by soonest contract expiration. A trimmed example (each row carries ~60 fields, including financing, occupancy, and demographics columns not shown here): ```json { "property_id": 800012345, "property_name": "Sunset Terrace Apartments", "address": "1200 W OLIVE AVE", "city": "FRESNO", "state": "CA", "zip": "93728", "latitude": 36.767, "longitude": -119.812, "metro_area": "Fresno, CA", "total_units": 96, "assisted_units": 95, "programs": ["Sec 8 NC"], "programs_detail": ["Section 8 (project-based)"], "contracts": ["CA16M000123"], "contract_expirations": ["2027-09-30"], "next_expiration": "2027-09-30", "mgmt_agent": "Pacific Property Management Inc", "mgmt_contact": "Jane Smith", "mgmt_phone": "(559) 555-0142", "mgmt_email": "jsmith@pacificpm.com", "site_phone": "(559) 555-0198", "phone": "(559) 555-0142", "has_email": true, "reac_score": 72, "reac_inspection_date": "2025-11-04", "risk_category": "Medium", "troubled": false, "on_watch_list": false, "in_default": false, "loan_maturity_date": "2029-06-01", "pct_occupied": 92.0, "rent_per_month": 1184.0, "deal_score": 30, "deal_score_breakdown": { "expiration_urgency": 20, "distress": 0, "condition": 8, "loan_maturity": 0, "occupancy": 0 } } ``` Other columns include `fha_number`, `original_loan_amount`, `debt_service_coverage_ratio`, `hud_held`, `hud_owned`, `rent_to_fmr_ratio`, `avg_tenant_income`, `pct_elderly_62plus`, `pct_disabled`, unit-mix percentages, `is_section8`, `is_202_811`, and the HUD field office (`hud_hub`). #### Example output A real sample from a live run: | property\_name | city | state | total\_units | assisted\_units | mgmt\_agent | mgmt\_phone | |---|---|---|---|---|---|---| | Almaden Garden Apartments | San Jose | CA | 52 | 36 | DKD Property Management Company | (408) 297-7849 ext. 103 | | VILLAGE WAY | Chatsworth | CA | 8 | 6 | VALLEY VILLAGE | 818 587 9450 X 132 | | LAS PALMAS | Los Angeles | CA | 74 | 74 | WSH Management Inc | 949-748-8209 | | NEW WEST I | Bloomington | CA | 4 | 4 | American Real Property Management, Inc. | (213) 252-5997 | ### Pricing This actor uses Apify **pay-per-event pricing: $5 per 1,000 properties** ($0.005 per result), effective from mid-July 2026. You're charged only for the property rows delivered after your filters — no subscription, no charge for empty runs. A 1,000-row pull of expiring Section 8 contracts in a state costs $5; a 25,000-row nationwide pull costs $125. The **free Apify plan is enough to try it** — test the deal score and expiring-contract filter on a real state list at no cost. ### Tips / FAQ **Is it legal to scrape HUD housing data?** Yes. The source is HUD's own public Multifamily Properties – Assisted ArcGIS open-data service — the same data HUD publishes for download. No login, no circumvention, no private data. **How fresh is the data?** Every run queries HUD's live feature service — there's no cached snapshot. Data is as current as HUD's latest published update. **What drives a high `deal_score`?** A subsidy contract expiring within 12–36 months, troubled/in-default/watch-list flags, a REAC score below 80 (more below 60), an FHA loan maturing within 36 months, and occupancy under 85%. Check `deal_score_breakdown` to see each component. **Why are some rents or demographics null?** HUD marks unreported survey values with negative sentinel codes (e.g. `-4`). This actor maps those to `null` rather than passing fake numbers into your underwriting. **What if HUD's service is down?** The actor retries transient errors with backoff; if HUD is completely unreachable, the run ends gracefully with a "temporarily unavailable — please retry" message and **you're charged nothing**. **Can I get only properties with a contact?** Yes — `onlyWithContact: true` drops any property without a management email or phone, so every row you pay for is actionable. ### Related actors - [Bulk Email Verifier](https://apify.com/flash_scraper/email-verifier) — verify management-contact emails before an outreach campaign - [Company & Domain Enricher](https://apify.com/flash_scraper/company-domain-enricher) — turn management-company domains into full firmographic records - [Local Business Leads Scraper](https://apify.com/flash_scraper/local-business-leads) — any local business category by city, with contact enrichment **Support:** found a bug or need a feature? Open an Issue on this actor's **Issues tab** — typical response within 1 business day. # 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: 'Section 8' (project-based rental assistance) or 'Section 202/811' (elderly / disabled housing). 'All' includes every 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 number of properties to return, e.g. 500. Lower values make runs faster and cheaper. ## 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("flash_scraper/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("flash_scraper/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 flash_scraper/hud-assisted-housing-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=flash_scraper/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": "yeR45m5qGzwvkKpcP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/flash_scraper~hud-assisted-housing-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-flash_scraper-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/flash_scraper~hud-assisted-housing-scraper/runs": { "post": { "operationId": "runs-sync-flash_scraper-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/flash_scraper~hud-assisted-housing-scraper/run-sync": { "post": { "operationId": "run-sync-flash_scraper-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: 'Section 8' (project-based rental assistance) or 'Section 202/811' (elderly / disabled housing). 'All' includes every 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 number of properties to return, e.g. 500. Lower values make runs faster and cheaper.", "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 } } } } } } } } } } ```