HUD Housing Data Scraper

Extract data from the U.S. Department of Housing and Urban Development (HUD) public APIs.

Datasets

1. HUD-Approved Housing Counselors (No Auth Required)

Search for HUD-approved housing counseling agencies by location. Uses the HUD searchByLocation API with automatic geocoding from city/state or ZIP code. No API token needed.

2. Fair Market Rents (FMR)

Get Fair Market Rent data by area. Requires a free HUD User API token from https://www.huduser.gov/hudapi/public/register

3. Income Limits

Get income limit data for housing programs. Requires a free HUD User API token.

Input Examples

Housing Counselors - Search by City + State

{
    "dataset": "housing-counselors",
    "city": "Washington",
    "state": "DC",
    "distance": 10,
    "maxItems": 50
}

Housing Counselors - Search by ZIP Code

{
    "dataset": "housing-counselors",
    "zipCode": "90210",
    "maxItems": 25
}

Housing Counselors - Search by Coordinates

{
    "dataset": "housing-counselors",
    "latitude": 34.05,
    "longitude": -118.25,
    "distance": 25
}

Housing Counselors - Filter by Service Type

{
    "dataset": "housing-counselors",
    "state": "CA",
    "city": "Los Angeles",
    "services": "DFC,HMC"
}

Fair Market Rents

{
    "dataset": "fair-market-rents",
    "hudApiToken": "YOUR_TOKEN",
    "entityId": "0999999999",
    "year": 2025
}

Income Limits

{
    "dataset": "income-limits",
    "hudApiToken": "YOUR_TOKEN",
    "entityId": "0999999999",
    "year": 2025
}

Service Type Codes (Housing Counselors)

• DFC - Default/Foreclosure Counseling
• FBC - Financial Management/Budget Counseling
• FBW - Financial, Budgeting and Credit Repair Workshops
• FHW - Fair Housing Pre-Purchase Education Workshops
• HIC - Home Improvement and Rehabilitation Counseling
• HMC - Home Buying/Pre-Purchase Counseling
• NDW - Non-Delinquency Post Purchase Workshops
• PLW - Predatory Lending Education Workshops
• PPC - Pre-Purchase Homebuyer Education Workshops
• PPW - Post-Purchase Education Workshops
• RHC - Rental Housing Counseling
• RHW - Rental Housing Workshops

How Location Search Works

For housing counselors, the actor uses the HUD searchByLocation API which requires latitude, longitude, and a distance radius. If you provide:

• Latitude + Longitude: Used directly
• City + State or ZIP code: Automatically geocoded to coordinates using OpenStreetMap Nominatim
• State only: Falls back to state capital coordinates with a 100-mile radius

Results can be further filtered by state code and service types.

Output

Housing counselor records include: agency ID, name, address, city, state, ZIP, phone, email, website, coordinates, languages, services, counseling methods, and faith-based indicator.

FMR and Income Limits records include rent/income data broken down by bedroom count or family size.