Property Level
Rental Value Forecast (Batch)
HouseCanary's 1-year rental value forecasts, supporting rental market outlooks and investment planning.
Fields include forecast % growth (decline) at 3, 6, and 12 month intervals into the future.
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 rental value information for 3 months with ZIP level Rental Price Index</td><td></td> </tr> <tr><td>month_03.value</td><td>integer</td><td>HouseCanary forecasted rental value within the 3 month time-period</td><td>2200</td> </tr> <tr><td>month_06</td><td>object</td><td>Forecasted rental value information for 6 months with ZIP level Rental Price Index</td><td></td> </tr> <tr><td>month_06.value</td><td>integer</td><td>HouseCanary forecasted rental value within the 6 month time-period</td><td>2300</td> </tr> <tr><td>month_12</td><td>object</td><td>Forecasted rental value information for 12 months with ZIP level Rental Price Index</td><td></td> </tr> <tr><td>month_12.value</td><td>integer</td><td>HouseCanary forecasted rental value within the 12 month time-period</td><td>2400</td> </tr> </table>post/v2/property/rental_value_forecast
Request body
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/rental_value_forecast": {
"result": {
"month_03": {
"value": 2200
},
"month_06": {
"value": 2300
},
"month_12": {
"value": 2400
}
}
},
"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"
]
}
}
}
]