Value Forecast

This endpoint provides a forecast time series of monthly block-median data for dollar value and dollar value per sq ft. The values are forecast one year into the future. You can specify a desired property type using the property_type request parameter. The default is SFD. You can also specify the order, limit, start, and end request parameters. The order parameter determines the chronological order to sort result items. The limit parameter sets the maximum integer number of result items to return. The start and end parameters set the beginning and ending date limits for result items, respectively, based on month in ISO 8601 format (e.g., 2015-01-01).

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>block_id</td><td>string</td><td>15-digit US-census block ID</td><td>360050001001000</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>

[
  {
    "block/value_ts_forecast": {
      "result": {
        "property_type": "TH",
        "time_series": [
          {
            "month": "2023-08-01",
            "value_median": 320000,
            "value_sqft_median": 210.5
          }
        ]
      }
    },
    "block_info": {
      "block_id": "360050001001000"
    }
  }
]