Lead Generation

HUD Elderly Assisted Housing Properties

Every HUD-assisted multifamily property designated for the elderly (Section 202 and other elderly client groups), with units, phone, and the management agent and its contact.

hud-elderly-housinglead-generationsenior-livingelderly-housinghudsection-202usapublic-record

10,848 rows in the dataset

Download the dataset

Get every row this scraper has collected as one CSV or JSONL file. If the data is older than maxAgeHours, the scraper is re-run with its configured settings first. The key needs the datasets:export scope.

DOWNLOAD_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/datasets/hud-elderly-housing/downloads" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{"maxAgeHours":24,"format":"csv"}' | jq -r '.id')while true; do  STATUS=$(curl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY" | jq -r '.status')  [ "$STATUS" != "refreshing" ] && break  sleep 5donecurl -s "https://api.pandorlabs.com/v1/downloads/$DOWNLOAD_ID/file" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -o dataset.csv

At its current 10,848 rows, this download costs 109 credits when the data is fresh enough, or 218 credits when it has to be refreshed first.

The rate is 1 credit per 100 rows cached and 2 credits live, charged on the rows in the dataset when the download becomes ready. A failed refresh is not charged. The file stays downloadable for 24 hours. See pricing.

Start a run

To choose the targets yourself, send the parameters below as input. The call returns 202 with the run; the key needs the scrapers:run scope and the account a positive credit balance.

curl -X POST "https://api.pandorlabs.com/v1/scrapers/hud-elderly-housing/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "FL",        "AZ",        "CA"      ],      "designations": [        "elderly",        "partially-elderly",        "family-and-elderly",        "section-202"      ],      "pageSize": 1000,      "requestDelayMs": 250    }  }'

A run is billed at the live rate once it finishes: 2 credits per 100 rows it collected. A run that collects nothing costs nothing.

Parameters

Every parameter is optional. Anything you leave out uses the default shown here; an unknown name or an invalid value is rejected with a 400 that lists each problem.

Targeting

states
string[]
States
Two-letter state codes. Empty means nationwide.
Default
none
Example
FL, AZ, CA
designations
enum[]
Elderly designations
From HUD's client group on each property. Section 202 covers properties funded for the elderly whose client group is blank.
Default
["elderly","partially-elderly","family-and-elderly","section-202"]
Allowed values
elderly
partially-elderly
family-and-elderly
section-202
maxItems
number
Max properties
Empty means the full elderly-designated set.
Default
none
Range
1 to 1000000

Advanced

pageSize
number
Page size
Default
1000
Range
1 to 2000
requestDelayMs
number
Delay between pages (ms)
Default
250
Range
0 to 30000
layerUrl
string
Feature layer URL
Override only if HUD moves the Multifamily Properties - Assisted layer.
Default
none

Input as JSON Schema

The same schema the API validates against. Use it as a tool input schema or to generate a typed client.

inputSchema

{  "type": "object",  "additionalProperties": false,  "properties": {    "states": {      "type": "array",      "items": {        "type": "string"      },      "maxItems": 1000,      "title": "States",      "description": "Two-letter state codes. Empty means nationwide.",      "default": [],      "examples": [        "FL, AZ, CA"      ]    },    "designations": {      "type": "array",      "items": {        "type": "string",        "enum": [          "elderly",          "partially-elderly",          "family-and-elderly",          "section-202"        ]      },      "uniqueItems": true,      "title": "Elderly designations",      "description": "From HUD's client group on each property. Section 202 covers properties funded for the elderly whose client group is blank.",      "default": [        "elderly",        "partially-elderly",        "family-and-elderly",        "section-202"      ]    },    "maxItems": {      "type": "number",      "minimum": 1,      "maximum": 1000000,      "title": "Max properties",      "description": "Empty means the full elderly-designated set."    },    "pageSize": {      "type": "number",      "minimum": 1,      "maximum": 2000,      "title": "Page size",      "default": 1000    },    "requestDelayMs": {      "type": "number",      "minimum": 0,      "maximum": 30000,      "title": "Delay between pages (ms)",      "default": 250    },    "layerUrl": {      "type": "string",      "maxLength": 2000,      "title": "Feature layer URL",      "description": "Override only if HUD moves the Multifamily Properties - Assisted layer."    }  }}

Run, poll, read rows

The run is asynchronous. Poll it until it reaches a terminal status and its billing is paid, then page through its rows. Until then the rows endpoint answers 409 (still queued or running) or 402 (payment required).

RUN_ID=$(curl -s -X POST "https://api.pandorlabs.com/v1/scrapers/hud-elderly-housing/runs" \  -H "Authorization: Bearer $PANDORLABS_KEY" \  -H "Content-Type: application/json" \  -d '{    "input": {      "states": [        "FL",        "AZ",        "CA"      ],      "designations": [        "elderly",        "partially-elderly",        "family-and-elderly",        "section-202"      ],      "pageSize": 1000,      "requestDelayMs": 250    }  }' | jq -r '.id')while true; do  RUN=$(curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID" \    -H "Authorization: Bearer $PANDORLABS_KEY")  STATUS=$(echo "$RUN" | jq -r '.status')  BILLING=$(echo "$RUN" | jq -r '.billing.status')  case "$STATUS" in queued|running) ;; *) [ "$BILLING" != "pending" ] && break ;; esac  sleep 5doneecho "$RUN" | jq '{status, rowCount, billing}'curl -s "https://api.pandorlabs.com/v1/runs/$RUN_ID/rows?page=1&limit=100" \  -H "Authorization: Bearer $PANDORLABS_KEY"

See the API reference for pagination, cancelling and listing runs.

Output fields

Rows have no fixed schema; these are the fields observed in the rows collected so far. Coverage is the share of rows where the field is present.

Field	Type	Coverage
address	string	100%
address_line_2	string	1%
assistance_programs	array	100%
assisted_units	number	100%
city	string	100%
client_group_code	string	100%
client_group_name	string	100%
client_group_type	string	100%
contract_numbers	array	100%
county	string	100%
county_fips	string	100%
elderly_designation	string	100%
has_service_coordinator	boolean	100%
hud_hub	string	100%
hud_servicing_site	string	100%
is_assisted_living	boolean	100%
is_board_and_care	boolean	100%
is_nursing_home	boolean	100%
is_section_202	boolean	100%
latitude	number	100%
longitude	number	100%
management_agent	string	100%
management_contact_address	string	99%
management_contact_city	string	99%
management_contact_email	string	99%
management_contact_name	string	99%
management_contact_phone	string	98%
management_contact_state	string	99%
management_contact_title	string	91%
management_contact_zip	string	99%
metro_area	string	91%
pct_residents_62_plus	number	93%
phone	string	80%
property_category	string	100%
property_id	string	100%
property_name	string	100%
reac_inspection_date	date	100%
reac_inspection_score	string	100%
state	string	100%
total_units	number	100%
zip	string	100%
created_at	date	100%
first_seen_at	date	100%
last_seen_at	date	100%
source_updated_at	date	100%
updated_at	date	100%
_id	string	100%