Value Forecast
Access one-year future forecasts for monthly blockgroup-median property values and dollar values per sq ft, enabling data-driven predictions for market trends and potential investment opportunities.
Source: HouseCanary
Pricing Tier: Premium
Updated: Monthly
Request Query Params
<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th><th>Enum Values</th></tr> <tr><td>blockgroup_id</td><td>string</td><td>12-digit census block group ID</td><td>060750615003</td> <td></td></tr> <tr><td>property_type</td><td>string</td><td>Desired property type to include in the time series. Defaults to SFD. One of [SFD, TH, CND, INC, MFH].</td><td></td> <td>[SFD, TH, CND, INC, MFH]</td></tr> <tr><td>order</td><td>string</td><td>Chronological order to sort result items. One of [asc or desc]. Defaults to asc.</td><td></td> <td>[asc, desc]</td></tr> <tr><td>limit</td><td>integer</td><td>Maximum integer number of result items to return. Defaults to null.</td><td>10</td> <td></td></tr> <tr><td>start</td><td>string</td><td>Beginning date limit for result items, based on month, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.</td><td>2015-01-01</td> <td></td></tr> <tr><td>end</td><td>string</td><td>Ending date limit for result items, based on month, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.</td><td>2015-01-01</td> <td></td></tr> </table>Response
<table><tr><th>Field</th><th>Type</th><th>Description</th><th>Example</th><th>Enum Values</th></tr> <tr><td>property_type</td><td>string</td><td>Type of property specified in the request. Defaults to SFD. One of ["SFD", "TH", "CND", "INC", "MFH"].</td><td>TH</td> <td>[SFD, TH, CND, INC, MFH]</td></tr> <tr><td>time_series</td><td>array</td><td>List of months and values.</td><td></td> <td></td></tr> <tr><td>time_series[]</td><td>object</td><td></td><td></td> <td></td></tr> <tr><td>time_series[].month</td><td>string</td><td>Month of the value in ISO format.</td><td>2023-08-01</td> <td></td></tr> <tr><td>time_series[].value_median</td><td>integer</td><td>Amount in dollars of the forecasted median property sale value for the month.</td><td>320000</td> <td></td></tr> <tr><td>time_series[].value_sqft_median</td><td>number</td><td>Amount in dollars of the forecasted median property sale value per square foot for the month.</td><td>210.5</td> <td></td></tr> </table>Query parameters
12-digit census block group ID
Desired property type to include in the time series. Defaults to SFD. One of [SFD, TH, CND, INC, MFH].
Chronological order to sort result items. One of [asc or desc]. Defaults to asc.
Maximum integer number of result items to return. Defaults to null.
Beginning date limit for result items, based on month, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.
Ending date limit for result items, based on month, in ISO 8601 format, i.e. 2015-01-01. Defaults to null.
Response
Success
Example response
[
{
"blockgroup/value_ts_forecast": {
"result": {
"property_type": "TH",
"time_series": [
{
"month": "2023-08-01",
"value_median": 320000,
"value_sqft_median": 210.5
}
]
}
},
"blockgroup_info": {
"block_id": "060750615003"
}
}
]