# HUD Multifamily & Affordable Housing Leads (`scrapesage/hud-multifamily-scraper`) Actor Scrape official HUD open data: assisted/Section 8, FHA-insured, LIHTC & public-housing properties with management contacts (name, phone, email), units, REAC scores, loan-maturity & contract-expiry timing signals and a lead score. Filter by state, type & units. B2B leads + monitoring. - **URL**: https://apify.com/scrapesage/hud-multifamily-scraper.md - **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community) - **Categories:** Real estate, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing $6.00 / 1,000 housing record / leads 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 Multifamily & Affordable Housing Leads — Owners, Managers, Contacts & Inspection Data Extract the **entire HUD multifamily & affordable-housing portfolio** as clean, contact-rich B2B leads — **assisted / Section 8, FHA-insured, LIHTC tax-credit, and public-housing-authority** properties in one unified schema. Every row ships the fields most lists leave blank: the **management company, named contact, title, direct phone and email**, plus units, occupancy, **REAC inspection scores**, financing, **loan-maturity & contract-expiration timing signals**, troubled/watch-list status, and a **lead score**. No login, no cookies, no browser, no API key — fast JSON extraction straight from official HUD open data. ### Why this HUD scraper? Public HUD data is scattered across four separate datasets and buried in 280-column ArcGIS layers full of geocoder noise. This actor merges them, de-duplicates, surfaces the contacts and the high-intent signals, and scores every record: | Data | Typical lists | This actor | |---|---|---| | Management company + named contact + title | ❌ | ✅ | | Contact **direct phone & email** | ❌ | ✅ (98% on assisted) | | Assisted / Section 8 + FHA-insured + LIHTC + PHA in one schema | ❌ single dataset | ✅ all four | | Units, assisted units, occupancy % | partial | ✅ | | **REAC physical-inspection score** + date | ❌ | ✅ | | **Loan-maturity date** (refinance timing) | ❌ | ✅ | | **Section 8 contract expiration** (renewal timing) | ❌ | ✅ | | Troubled / watch-list / default flags | ❌ | ✅ | | LIHTC allocation $, target population, financing sources | ❌ | ✅ | | Public housing authority exec-director phone & email | ❌ | ✅ | | Lead score (0–100) + lead signals | ❌ | ✅ | | Rich source-field passthrough (every meaningful native field) | ❌ | ✅ | ### Use cases - **Property-management & proptech sales** — reach the management company and named on-site contact at every assisted and FHA-insured property. Score by units (`totalUnits`) and contact them directly (`bestEmail`, `bestPhone`). - **Affordable-housing finance & LIHTC** — find owners with mortgages maturing soon (`loanMaturingWithinMonths`) or Section 8 contracts expiring (`contractExpiringWithinMonths`) for refinance, recapitalization and acquisition outreach. - **Capital improvement / energy retrofit / ESCO** — target properties with **low REAC scores** (`reacScoreBelow`) or troubled/watch-list status — the highest capital-needs intent. - **Multifamily insurance & risk** — build prospect lists by property type (senior, assisted living, nursing home), size and state. - **Government / housing-authority vendors** — sell software, modernization, RAD conversion and services to Public Housing Authorities with exec-director contacts and funding amounts. - **Market & portfolio intelligence** — map subsidized & tax-credit inventory by metro, units, rents and resident demographics. ### How to use 1. [Sign up for Apify](https://console.apify.com/sign-up) — the free plan is enough to try this actor. 2. Open the **HUD Multifamily & Affordable Housing Leads** actor, choose your **datasets** and a **state** (or city / ZIP), set any filters, and click **Start**. 3. Watch results stream into the dataset table. 4. **Export** as JSON, CSV, Excel, XML, or RSS — or pull results programmatically via the [Apify API](https://docs.apify.com/api/v2). ### Input ```json { "datasets": ["assisted", "insured", "pha"], "states": ["TX", "FL"], "propertyTypes": ["senior", "assistedLiving"], "minUnits": 50, "hasEmail": true, "loanMaturingWithinMonths": 24, "maxResults": 1000, "sortBy": "leadScore" } ```` - **datasets** *(default `assisted`, `insured`, `pha`)* — which HUD sources to merge. `assisted` (Section 8/202/811/PRAC) and `insured` (FHA) carry the richest contacts; `pha` adds housing-authority exec contacts; `lihtc` adds the largest property universe (allocation/units/target population — note HUD withholds owner contacts on most LIHTC rows). - **states / cities / counties / zipCodes / nameQuery** — location & name filters (combine with AND). - **propertyTypes** — `family`, `senior`, `assistedLiving`, `nursingHome`, `boardAndCare`, `hospital`, `disabled`, `elderly`, `homeless`. - **minUnits / maxUnits** — size filters. - **hasEmail / hasPhone** — keep only contactable records. - **subsidizedOnly / troubledOnly** — Section 8 / active-assistance, or troubled / watch-list / default. - **loanMaturingWithinMonths** — refinance-timing signal (FHA-insured). - **contractExpiringWithinMonths** — Section 8 renewal-timing signal. - **reacScoreBelow** — capital-needs signal (low physical-inspection score). - **sortBy** — `leadScore` (recommended), `unitsHigh`, `recentInspection`, `loanMaturitySoon`, `source`. - **monitorMode / monitorKey** — only emit new / changed records since the last run (see below). ### Output One record per property or housing authority: ```json { "recordType": "property", "dataset": "assisted", "recordId": "800023743", "name": "CHEYENNE HANDICAPPED", "address1": "1215 CLEVELAND AVE", "city": "Cheyenne", "county": "Laramie", "state": "WY", "zip": "82001", "latitude": 41.1365, "longitude": -104.7564, "metroArea": "Cheyenne, WY Metropolitan Statistical Area", "propertyCategory": "202/811", "propertyTypes": ["senior"], "totalUnits": 12, "assistedUnits": 12, "occupancyPct": 87.04, "managementCompany": "MAGIC CITY ENTERPRISES, INC.", "contactName": "Nancy Gordy", "contactTitle": "Property Manager", "contactPhone": "3077712812", "contactEmail": "ngordy@mcewyo.org", "financingType": "202/811", "originalLoanAmount": 396800, "loanMaturityDate": "2027-12-01", "subsidyPrograms": ["Section 8"], "contracts": [{ "number": "WY99T856003", "programType": "202/8 NC", "units": 12, "expirationDate": null }], "reacInspectionScore": 99, "reacInspectionDate": "2025-04-22", "troubledStatus": "N", "isOnWatchList": false, "residentProfile": { "avgRentPerMonth": 343, "medianIncome": 13441, "pctElderly": 63.64 }, "bestEmail": "ngordy@mcewyo.org", "bestPhone": "3077712812", "leadScore": 80, "leadSignals": ["Has contact email", "Has direct phone", "Named contact", "Management company identified", "Loan maturing within 24 months — refinance window", "Senior / elderly housing"], "mapUrl": "https://www.google.com/maps/search/?api=1&query=41.1365,-104.7564", "sourceFields": { "...": "every meaningful native HUD field, cleaned" }, "scrapedAt": "2026-06-20T22:55:00.000Z" } ``` Public-housing-authority rows (`recordType: "housingAuthority"`) add `execDirectorPhone`, `execDirectorEmail`, `programType`, `phasDesignation`, `section8Units` and a `funding` object (operating / capital / ROSS / FSS grants). LIHTC rows add `allocationAmount`, `creditType`, `yearPlacedInService`, `targetPopulation`, `financingSources`, `difficultDevelopmentArea` and `qualifiedCensusTract`. ### Monitoring mode — only new & changed leads Turn on **monitorMode** and the actor remembers every record it has returned (in a named key-value store) and emits **only** records that are **new** or whose key fields changed (contacts, units, REAC score, troubled status, loan/contract dates) since the last run — each tagged with a `monitorEvent` of `new` or `updated`. This is **complementary to, not a replacement for, [Apify Schedules](https://docs.apify.com/platform/schedules)**: the Schedule decides *when* the actor runs, monitoring decides *what counts as new*. Use a distinct `monitorKey` per saved watch (e.g. one per state or property type) so different monitors keep separate memory. ### Automate & schedule Run this actor on autopilot and pull results into your own stack: - **[Apify API](https://docs.apify.com/api/v2)** — start runs, fetch datasets, and manage schedules over REST. - **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** — official SDKs. - **[Schedules](https://docs.apify.com/platform/schedules)** — run it daily/weekly with `monitorMode` to capture newly added or changed properties as leads. - **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** — trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes. ```js import { ApifyClient } from 'apify-client'; const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' }); const run = await client.actor('scrapesage/hud-multifamily-scraper').call({ datasets: ['assisted', 'insured'], states: ['TX'], minUnits: 100, hasEmail: true, sortBy: 'leadScore', }); const { items } = await client.dataset(run.defaultDatasetId).listItems(); console.log(`Got ${items.length} HUD multifamily leads`); ``` ### Integrate with any app Connect the dataset to 5,000+ apps — no code required: - **[Make](https://docs.apify.com/platform/integrations/make)** — multi-step automation scenarios. - **[Zapier](https://docs.apify.com/platform/integrations/zapier)** — push new property leads straight into your CRM. - **[Slack](https://docs.apify.com/platform/integrations/slack)** — get notified when a monitored watch finds new properties. - **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** — auto-export every run to a spreadsheet. - **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** — pipe results into your data warehouse. - **[GitHub](https://docs.apify.com/platform/integrations/github)** — trigger runs from commits or releases. ### Use with AI assistants (MCP) The output is clean, LLM-ready JSON. You can call this actor from Claude, ChatGPT, or any agent framework through the **[Apify MCP server](https://docs.apify.com/platform/integrations/mcp)** — ask your assistant to "find senior HUD properties in Texas with a contact email and a low inspection score" and let it run this scraper for you. ### More US B2B & real-estate data from scrapesage Build a complete property & owner intelligence stack: - **[US Property Records Scraper](https://apify.com/scrapesage/us-property-records-scraper)** — parcels, owners, mailing addresses & absentee-owner flags from county assessors. - **[US Building Permits Scraper](https://apify.com/scrapesage/us-building-permits-scraper)** — construction & renovation permits as project-intent signals. - **[Crexi Scraper](https://apify.com/scrapesage/crexi-scraper)** — commercial real-estate listings, brokers & pricing. - **[US Business Formation Scraper](https://apify.com/scrapesage/us-business-formation-scraper)** — newly registered businesses from state filings. - **[SBA Loan Leads Scraper](https://apify.com/scrapesage/sba-loan-leads-scraper)** — SBA 7(a) & 504 financed small businesses. - **[Form 5500 ERISA Scraper](https://apify.com/scrapesage/form-5500-erisa-scraper)** — employer retirement & benefit plan leads. - **[US Banks & Credit Unions Scraper](https://apify.com/scrapesage/us-banks-credit-unions-scraper)** — FDIC banks + NCUA credit unions in one schema. - **[FMCSA Trucking Scraper](https://apify.com/scrapesage/fmcsa-trucking-scraper)** — licensed motor carriers & brokers. ### Tips - **Target a market**: always set a `states` filter (and optionally `cities`) for the fastest, cheapest runs. Without one, the actor scans the full national dataset(s). - **Best contacts**: keep `datasets` on `assisted` + `insured` and turn on `hasEmail` for the cleanest ready-to-contact list. - **Refinance pipeline**: combine `datasets: ["insured"]` with `loanMaturingWithinMonths: 36` and `sortBy: "loanMaturitySoon"`. - **Turnaround / capex**: set `troubledOnly: true` or `reacScoreBelow: 60`. - **LIHTC market data**: select `datasets: ["lihtc"]` and `sortBy: "unitsHigh"` — note these rows carry property & allocation data, not direct owner contacts. ### FAQ **Where does the data come from?** Official U.S. Department of Housing and Urban Development (HUD) open data — the Multifamily Assisted, HUD-Insured Multifamily, LIHTC and Public Housing Authority datasets published on HUD's open-data portal. No API key or login required. **Which datasets have contact details?** The **Assisted** and **FHA-Insured** multifamily datasets carry management-company contacts (name, title, phone, email) on ~63–98% of rows. **Public Housing Authorities** carry agency and executive-director phone & email. **LIHTC** carries property, allocation and target-population data, but HUD withholds owner contacts on most LIHTC rows. **Why are some fields null?** Fields are `null` only when HUD doesn't publish them for that record (e.g. an FHA-insured property with no Section 8 contract, or a property HUD never assigned a REAC score). The scraper never skips data that exists — and the full `sourceFields` object preserves every meaningful native field. **Can I export to Google Sheets, CSV, or Excel?** Yes — one click in the dataset view, or automatically on every run via the [Google Drive integration](https://docs.apify.com/platform/integrations/drive). **How do I get only new or changed properties?** Turn on `monitorMode` and run on a [Schedule](https://docs.apify.com/platform/schedules). Each run emits only `new` or `updated` records. **Is this legal?** This actor collects publicly available government data only. You are responsible for using it in compliance with applicable laws (including CAN-SPAM / TCPA for outreach and any privacy rules that apply to personal contact data). ### Need help? Open an issue on the actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome — this actor is actively maintained. # Actor input Schema ## `datasets` (type: `array`): Which official HUD datasets to pull. Assisted (Section 8 / 202 / 811 / PRAC) and FHA-Insured multifamily carry the richest contacts — management company + named contact + phone + email. Public Housing Authorities add agency phone/email + executive-director contacts. LIHTC tax-credit properties add the largest property universe with allocation, units & target population (note: HUD withholds owner contacts on most LIHTC rows). ## `states` (type: `array`): Filter by state — two-letter USPS codes, e.g. CA, TX, NY, FL. Leave empty for all states & territories (slower; scans the whole country). ## `cities` (type: `array`): Filter by city name (case-insensitive contains), e.g. Houston, Brooklyn, Phoenix. Combine with a state for accuracy. ## `counties` (type: `array`): Filter by county name (case-insensitive contains), e.g. Harris, Cook, Maricopa. ## `zipCodes` (type: `array`): Filter by property ZIP — full ZIP (77002) or a prefix (770 matches all 770xx). ## `nameQuery` (type: `string`): Only return records whose property name or management company contains this text (case-insensitive), e.g. village, senior, or a specific owner / management company name. ## `propertyTypes` (type: `array`): Keep only properties of the selected type(s). Derived from HUD program flags. Leave empty for all. ## `minUnits` (type: `integer`): Only properties / agencies with at least this many total units. Great for filtering to institutional-size owners. ## `maxUnits` (type: `integer`): Only properties / agencies with at most this many total units. ## `hasEmail` (type: `boolean`): Only return records that include a contact email (management-agent email or, for housing authorities, agency / executive-director email). ## `hasPhone` (type: `boolean`): Only return records that include a contact phone number. ## `subsidizedOnly` (type: `boolean`): Only properties currently flagged as subsidized or with active rental assistance (Section 8, PRAC, PAC, etc.). ## `troubledOnly` (type: `boolean`): Only properties flagged as troubled, on the HUD watch list, or in loan default / delinquency — high intent for turnaround, repair, refinance and management-change services. ## `loanMaturingWithinMonths` (type: `integer`): Only FHA-insured properties whose mortgage matures within this many months — a refinance / recapitalization timing signal. E.g. 24. ## `contractExpiringWithinMonths` (type: `integer`): Only properties whose Section 8 / assistance contract expires within this many months — a renewal / repositioning timing signal. E.g. 12. ## `reacScoreBelow` (type: `integer`): Only properties whose last REAC physical-inspection score is below this value (0–100) — capital-needs / repair intent. E.g. 60. ## `maxResults` (type: `integer`): Maximum number of records to return in this run. ## `sortBy` (type: `string`): Lead score = most contactable / highest-intent first (recommended). Most units ranks by size. Recent inspection / Loan maturing soonest rank by those signals. Source order = fastest on very large limits. ## `deduplicateResults` (type: `boolean`): Skip duplicate properties (same HUD property ID across the Assisted + Insured datasets) within this run (recommended). ## `monitorMode` (type: `boolean`): Remember which records were already returned (in a named key-value store) and emit ONLY records that are new or whose key fields changed since the last run — each tagged with a monitorEvent (new or updated). HUD refreshes this data regularly; run on a Schedule to capture fresh leads. Works alongside Apify Schedules (the schedule starts the run; monitoring decides what is new). ## `monitorKey` (type: `string`): Names the memory used by monitoring mode. Use a distinct key per saved watch (e.g. per state or property type) so different monitors don't share state. ## `proxyConfiguration` (type: `object`): Optional proxy. HUD open data is queried directly and needs no proxy — leave this off for the fastest queries. Enable Apify Proxy only if your network requires it. ## Actor input object example ```json { "datasets": [ "assisted", "insured", "pha" ], "states": [ "WY" ], "hasEmail": false, "hasPhone": false, "subsidizedOnly": false, "troubledOnly": false, "maxResults": 1000, "sortBy": "leadScore", "deduplicateResults": true, "monitorMode": false, "monitorKey": "default", "proxyConfiguration": { "useApifyProxy": false } } ``` # Actor output Schema ## `results` (type: `string`): All scraped property / housing-authority records in the default dataset, each with firmographics, management contacts, financing, subsidy, inspection scores and a lead score. # 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 = { "datasets": [ "assisted", "insured", "pha" ], "states": [ "WY" ], "proxyConfiguration": { "useApifyProxy": false } }; // Run the Actor and wait for it to finish const run = await client.actor("scrapesage/hud-multifamily-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 = { "datasets": [ "assisted", "insured", "pha", ], "states": ["WY"], "proxyConfiguration": { "useApifyProxy": False }, } # Run the Actor and wait for it to finish run = client.actor("scrapesage/hud-multifamily-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 '{ "datasets": [ "assisted", "insured", "pha" ], "states": [ "WY" ], "proxyConfiguration": { "useApifyProxy": false } }' | apify call scrapesage/hud-multifamily-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=scrapesage/hud-multifamily-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "HUD Multifamily & Affordable Housing Leads", "description": "Scrape official HUD open data: assisted/Section 8, FHA-insured, LIHTC & public-housing properties with management contacts (name, phone, email), units, REAC scores, loan-maturity & contract-expiry timing signals and a lead score. Filter by state, type & units. B2B leads + monitoring.", "version": "0.1", "x-build-id": "4dM74dbTlK5cDuhwH" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapesage~hud-multifamily-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapesage-hud-multifamily-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/scrapesage~hud-multifamily-scraper/runs": { "post": { "operationId": "runs-sync-scrapesage-hud-multifamily-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/scrapesage~hud-multifamily-scraper/run-sync": { "post": { "operationId": "run-sync-scrapesage-hud-multifamily-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": { "datasets": { "title": "Data sources", "type": "array", "description": "Which official HUD datasets to pull. Assisted (Section 8 / 202 / 811 / PRAC) and FHA-Insured multifamily carry the richest contacts — management company + named contact + phone + email. Public Housing Authorities add agency phone/email + executive-director contacts. LIHTC tax-credit properties add the largest property universe with allocation, units & target population (note: HUD withholds owner contacts on most LIHTC rows).", "items": { "type": "string", "enum": [ "assisted", "insured", "lihtc", "pha" ], "enumTitles": [ "Assisted / Section 8 multifamily (mgmt contacts + email)", "FHA-Insured multifamily (mgmt contacts + loan data)", "LIHTC tax-credit properties (property + allocation data)", "Public Housing Authorities (agency + exec-director contacts)" ] }, "default": [ "assisted", "insured", "pha" ] }, "states": { "title": "States", "type": "array", "description": "Filter by state — two-letter USPS codes, e.g. CA, TX, NY, FL. Leave empty for all states & territories (slower; scans the whole country).", "items": { "type": "string" } }, "cities": { "title": "Cities", "type": "array", "description": "Filter by city name (case-insensitive contains), e.g. Houston, Brooklyn, Phoenix. Combine with a state for accuracy.", "items": { "type": "string" } }, "counties": { "title": "Counties", "type": "array", "description": "Filter by county name (case-insensitive contains), e.g. Harris, Cook, Maricopa.", "items": { "type": "string" } }, "zipCodes": { "title": "ZIP codes (prefix)", "type": "array", "description": "Filter by property ZIP — full ZIP (77002) or a prefix (770 matches all 770xx).", "items": { "type": "string" } }, "nameQuery": { "title": "Name contains", "type": "string", "description": "Only return records whose property name or management company contains this text (case-insensitive), e.g. village, senior, or a specific owner / management company name." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Keep only properties of the selected type(s). Derived from HUD program flags. Leave empty for all.", "items": { "type": "string", "enum": [ "family", "senior", "assistedLiving", "nursingHome", "boardAndCare", "hospital", "disabled", "elderly", "homeless" ], "enumTitles": [ "Family", "Senior / elderly (202/811)", "Assisted living", "Nursing home", "Board & care", "Hospital", "Disabled (811)", "Elderly (LIHTC target)", "Homeless (LIHTC target)" ] } }, "minUnits": { "title": "Min units", "type": "integer", "description": "Only properties / agencies with at least this many total units. Great for filtering to institutional-size owners." }, "maxUnits": { "title": "Max units", "type": "integer", "description": "Only properties / agencies with at most this many total units." }, "hasEmail": { "title": "Has email only", "type": "boolean", "description": "Only return records that include a contact email (management-agent email or, for housing authorities, agency / executive-director email).", "default": false }, "hasPhone": { "title": "Has phone only", "type": "boolean", "description": "Only return records that include a contact phone number.", "default": false }, "subsidizedOnly": { "title": "Subsidized / Section 8 only", "type": "boolean", "description": "Only properties currently flagged as subsidized or with active rental assistance (Section 8, PRAC, PAC, etc.).", "default": false }, "troubledOnly": { "title": "Troubled / watch-list only", "type": "boolean", "description": "Only properties flagged as troubled, on the HUD watch list, or in loan default / delinquency — high intent for turnaround, repair, refinance and management-change services.", "default": false }, "loanMaturingWithinMonths": { "title": "Loan maturing within (months)", "type": "integer", "description": "Only FHA-insured properties whose mortgage matures within this many months — a refinance / recapitalization timing signal. E.g. 24." }, "contractExpiringWithinMonths": { "title": "Subsidy contract expiring within (months)", "type": "integer", "description": "Only properties whose Section 8 / assistance contract expires within this many months — a renewal / repositioning timing signal. E.g. 12." }, "reacScoreBelow": { "title": "REAC inspection score below", "type": "integer", "description": "Only properties whose last REAC physical-inspection score is below this value (0–100) — capital-needs / repair intent. E.g. 60." }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of records to return in this run.", "default": 1000 }, "sortBy": { "title": "Sort order", "enum": [ "leadScore", "unitsHigh", "recentInspection", "loanMaturitySoon", "source" ], "type": "string", "description": "Lead score = most contactable / highest-intent first (recommended). Most units ranks by size. Recent inspection / Loan maturing soonest rank by those signals. Source order = fastest on very large limits.", "default": "leadScore" }, "deduplicateResults": { "title": "Deduplicate within a run", "type": "boolean", "description": "Skip duplicate properties (same HUD property ID across the Assisted + Insured datasets) within this run (recommended).", "default": true }, "monitorMode": { "title": "Monitoring mode — only new / changed records", "type": "boolean", "description": "Remember which records were already returned (in a named key-value store) and emit ONLY records that are new or whose key fields changed since the last run — each tagged with a monitorEvent (new or updated). HUD refreshes this data regularly; run on a Schedule to capture fresh leads. Works alongside Apify Schedules (the schedule starts the run; monitoring decides what is new).", "default": false }, "monitorKey": { "title": "Monitor key", "type": "string", "description": "Names the memory used by monitoring mode. Use a distinct key per saved watch (e.g. per state or property type) so different monitors don't share state.", "default": "default" }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Optional proxy. HUD open data is queried directly and needs no proxy — leave this off for the fastest queries. Enable Apify Proxy only if your network requires it.", "default": { "useApifyProxy": false } } } }, "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 } } } } } } } } } } ```