Property Level

Value Forecast (Batch)

HouseCanary's 3-year home price forecasts, essential for understanding market trends and making informed investment decisions.

Home values are forecast 3 years into the future using HouseCanary's AVM values and home price index (HPI) at a zip code level. Fields include forecast % growth (decline) at the following monthly intervals into the future: 3, 6, 12, 18, 24, 30 and 36.

Source: HouseCanary

Pricing Tier: Premium

Updated: Monthly

Request Body Fields

<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th></tr> <tr><td>[]</td><td>object</td><td></td><td></td> </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>month_03</td><td>object</td><td>Forecasted value information for 3 months with ZIP level Home Price Index</td><td></td> </tr> <tr><td>month_03.value</td><td>integer</td><td>HouseCanary forecasted value within the 3 month period</td><td>350000</td> </tr> <tr><td>month_06</td><td>object</td><td>Forecasted value information for 6 months with ZIP level Home Price Index</td><td></td> </tr> <tr><td>month_06.value</td><td>integer</td><td>HouseCanary forecasted value within the 6 month period</td><td>365000</td> </tr> <tr><td>month_12</td><td>object</td><td>Forecasted value information for 12 months with ZIP level Home Price Index</td><td></td> </tr> <tr><td>month_12.value</td><td>integer</td><td>HouseCanary forecasted value within the 12 month period</td><td>375000</td> </tr> <tr><td>month_18</td><td>object</td><td>Forecasted value information for 18 months with ZIP level Home Price Index</td><td></td> </tr> <tr><td>month_18.value</td><td>integer</td><td>HouseCanary forecasted value within the 18 month period</td><td>380000</td> </tr> <tr><td>month_24</td><td>object</td><td>Forecasted value information for 24 months with ZIP level Home Price Index</td><td></td> </tr> <tr><td>month_24.value</td><td>integer</td><td>HouseCanary forecasted value within the 24 month period</td><td>390000</td> </tr> <tr><td>month_30</td><td>object</td><td>Forecasted value information for 30 months with ZIP level Home Price Index</td><td></td> </tr> <tr><td>month_30.value</td><td>integer</td><td>HouseCanary forecasted value within the 30 month period</td><td>400000</td> </tr> <tr><td>month_36</td><td>object</td><td>Forecasted value information for 36 months with ZIP level Home Price Index</td><td></td> </tr> <tr><td>month_36.value</td><td>integer</td><td>HouseCanary forecasted value within the 36 month period</td><td>410000</td> </tr> </table>
post/v2/property/value_forecast

Request body

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

Example request

[
  {
    "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
    "address": "123 Main St",
    "unit": "Apt 1B",
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94105"
  }
]

Response

Success

Example response

[
  {
    "property/value_forecast": {
      "result": {
        "month_03": {
          "value": 350000
        },
        "month_06": {
          "value": 365000
        },
        "month_12": {
          "value": 375000
        },
        "month_18": {
          "value": 380000
        },
        "month_24": {
          "value": 390000
        },
        "month_30": {
          "value": 400000
        },
        "month_36": {
          "value": 410000
        }
      }
    },
    "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"
        ]
      }
    }
  }
]