API Reference
Five endpoints. One unified schema.
REST over HTTPS. JSON request and response. Bearer token authentication. Each call costs 60 credits — no hidden tiering.
Base URL
api.homeanalytics.ai
Auth
Bearer $HA_KEY
Cost / call
60 credits
01
Property Details
Canonical property record: address, parcel, ownership, structural attributes, hazard exposure.
GET/v1/property
{
"property_id": "ha_8f3e2…",
"address": { "line1": "350 5th Ave", "city": "New York", "state": "NY" },
"parcel": { "apn": "1-...", "lot_size_sqft": 79288 },
"structure": { "year_built": 1931, "stories": 102, "sqft": 2768591 },
"_meta": { "score": 0.98, "sources": ["mls","public","avm"] }
}02
AVM Valuation
Reconciled automated valuation model output with a 0–1 confidence score and per-source breakdown.
GET/v1/avm
{
"value": 1842500,
"low": 1720000, "high": 1965000,
"confidence": 0.94,
"as_of": "2025-04-22",
"sources_count": 3
}03
Mortgage Details
Active and historical liens, lender, origination date, balance estimate, equity position.
GET/v1/mortgage
{
"liens": [{
"position": 1, "lender": "Wells Fargo",
"origination_date": "2019-08-12",
"original_amount": 980000,
"balance_estimate": 812400
}],
"equity_estimate": 1030100
}04
Nearby Sales
Comparable closed sales within a configurable radius, scored for similarity to the subject property.
GET/v1/comps
{
"comps": [{
"property_id": "ha_a91…",
"distance_mi": 0.31,
"sale_price": 1795000,
"sale_date": "2025-02-04",
"similarity": 0.91
}]
}05
Market Trends
Median price, price-per-sqft, days-on-market, inventory and YoY changes for ZIP, city or MSA.
GET/v1/trends
{
"geo": { "type": "zip", "value": "10118" },
"median_price": 1290000,
"ppsf": 1820,
"dom": 41,
"yoy": { "median_price": 0.034, "inventory": -0.12 }
}