Zipcode Level
Home Price Index Forecast From Address
Access HouseCanary's proprietary forecasted price return metrics for a ZIP code, derived from the HouseCanary home price index (HPI).
Source: HouseCanary
Pricing Tier: Premium
Updated: Monthly
Request Query Params
<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>slug</td><td>string</td><td>Unique readable string identifier for the property</td><td>123-Main-St-Apt-1B-San-Francisco-CA-94132</td> </tr> <tr><td>address</td><td>string</td><td>Either a single URL-safe string ("slug") identifying the address, or just a building number, street name, and optionally unit number (if not a slug the payload must also include other identifiers)</td><td>123 Main St</td> </tr> <tr><td>unit</td><td>string</td><td>Unit number for the property, if needed and not already specified in the address string</td><td>Apt 1B</td> </tr> <tr><td>city</td><td>string</td><td>City in which the property is located</td><td>San Francisco</td> </tr> <tr><td>state</td><td>string</td><td>2-letter acronym of the US state in which the property is located</td><td>CA</td> </tr> <tr><td>zipcode</td><td>string</td><td>5-digit US zipcode in which the property is located</td><td>94105</td> </tr> </table>Response
<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>cagr_12mo_f</td><td>number</td><td>Forecast 1-year compound annual growth rate (CAGR)</td><td>0.035</td> </tr> <tr><td>cagr_24mo_f</td><td>number</td><td>Forecast 2-year compound annual growth rate (CAGR)</td><td>0.045</td> </tr> <tr><td>cagr_36mo_f</td><td>number</td><td>Forecast 3-year compound annual growth rate (CAGR)</td><td>0.055</td> </tr> <tr><td>returns_12mo_f</td><td>number</td><td>Forecast home price appreciation for the next 12 months based on HPI forecast</td><td>0.06</td> </tr> <tr><td>returns_24mo_f</td><td>number</td><td>Forecast home price appreciation for the next 24 months based on HPI forecast</td><td>0.12</td> </tr> <tr><td>returns_36mo_f</td><td>number</td><td>Forecast home price appreciation for the next 36 months based on HPI forecast</td><td>0.18</td> </tr> <tr><td>max_12mo_loss</td><td>number</td><td>Historical max percent loss in HPI over a 12 month period</td><td>-0.08</td> </tr> <tr><td>risk_12mo_loss</td><td>number</td><td>Probability that this market's HPI will be lower 12 months from now than the current HPI</td><td>0.25</td> </tr> </table>get/v2/property/zip_hpi_forecast
Query parameters
slugstring
Unique readable string identifier for the property
addressstring required
Either a single URL-safe string ("slug") identifying the address, or just a building number, street name, and optionally unit number (if not a slug the payload must also include other identifiers)
unitstring
Unit number for the property, if needed and not already specified in the address string
citystring
City in which the property is located
statestring
2-letter acronym of the US state in which the property is located
zipcodestring
5-digit US zipcode in which the property is located
Response
Success
Example response
[
{
"property/zip_hpi_forecast": {
"result": {
"cagr_12mo_f": 0.035,
"cagr_24mo_f": 0.045,
"cagr_36mo_f": 0.055,
"returns_12mo_f": 0.06,
"returns_24mo_f": 0.12,
"returns_36mo_f": 0.18,
"max_12mo_loss": -0.08,
"risk_12mo_loss": 0.25
}
},
"address_info": {
"address_full": "123 Main St San Francisco CA 94132",
"slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
"address": "123 Main St",
"unit": "Apt 1B",
"city": "San Francisco",
"state": "CA",
"zipcode": "94132",
"zipcode_plus4": "1234",
"block_id": "060750313013007",
"blockgroup_id": "060750201004",
"county_fips": "06075",
"metrodiv": "41860",
"msa": "41860",
"geo_precision": "rooftop",
"lat": 37.789,
"lng": -122.401,
"status": {
"match": true,
"details": [
"Address fully verified"
],
"requested_item": {
"zipcode": "94132",
"address": "123+Main+St"
},
"changes": [
"State added or changed"
]
}
}
}
]