Property Level
Value Analysis
Value Analysis provides a set of automated checks to test the feasibility of a property value based on HouseCanary’s data and models. It provides a recommended approach for coming to a high-confidence value for the property.
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>A single URL-safe string identifying the address (obtained from HouseCanary)</td><td>1624-E-Dogwood-Ln-Gilbert-AZ-85295</td> </tr> <tr><td>street_address</td><td>string</td><td>Building number, street name and unit number</td><td>123 Main St San Francisco CA 94132</td> </tr> <tr><td>zipcode</td><td>integer</td><td>5-digit ZIP code</td><td>94132</td> </tr> <tr><td>estimated_value</td><td>integer</td><td>Outside estimate of the property’s value, maybe from a BPO or previous appraised value</td><td>325000</td> </tr> <tr><td>gla_sqft</td><td>integer</td><td>Gross living area of property in square feet</td><td>2750</td> </tr> <tr><td>include_comp_based_analysis</td><td>boolean</td><td>Whether to include comp-based analysis (response may be slower if included)</td><td>true</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>checks</td><td>object</td><td>Preliminary data checks to determine whether HouseCanary can provide an AVM for the property in question</td><td></td> <td></td></tr> <tr><td>checks.All pre-analysis checks passed</td><td>boolean</td><td><code>true</code> if all the other checks are <code>true</code>, <code>false</code> otherwise</td><td>true</td> <td></td></tr> <tr><td>checks.Address is supported</td><td>boolean</td><td><code>true</code> if the provided address can be parsed, <code>false</code> otherwise</td><td>true</td> <td></td></tr> <tr><td>checks.Address is complete</td><td>boolean</td><td><code>true</code> if the provided address includes all necessary detail to resolve to a specific residence, <code>false</code> otherwise (most commonly a <code>false</code> value indicates a missing unit number for a multi-unit property address)</td><td>true</td> <td></td></tr> <tr><td>checks.Precise geocode is available for address</td><td>boolean</td><td><code>true</code> if HouseCanary has a rooftop accurate geocode for the address, <code>false</code> otherwise</td><td>true</td> <td></td></tr> <tr><td>checks.Property at address is of supported type</td><td>boolean</td><td>Returns <code>true</code> if the property at the specified address is of a supported type; <code>false</code> otherwise.</td><td>true</td> <td></td></tr> <tr><td>checks.Census block group information is available</td><td>boolean</td><td><code>true</code> if HouseCanary has blockgroup value distribution data for the blockgroup containing the property,<code>false</code> otherwise</td><td>true</td> <td></td></tr> <tr><td>checks.Enough information on neighborhood characteristics is available</td><td>boolean</td><td>True if HouseCanary has value per square foot data for at least 70% of properties in the blockgroup, False otherwise</td><td>true</td> <td></td></tr> <tr><td>checks.Gross living area of property is available or provided as input</td><td>boolean</td><td>True if HouseCanary has data for the gross living area of the property or it was provided in the request as the gla_sqft value, False otherwise</td><td>true</td> <td></td></tr> <tr><td>checks.Comps available for analysis</td><td>boolean</td><td>True if at least 5 highly similar comparable properties exist, False otherwise</td><td>true</td> <td></td></tr> <tr><td>input_params</td><td>object</td><td></td><td></td> <td></td></tr> <tr><td>input_params.slug</td><td>string</td><td>A single URL-safe string identifying the address (obtained from HouseCanary)</td><td>1624-E-Dogwood-Ln-Gilbert-AZ-85295</td> <td></td></tr> <tr><td>input_params.product_type</td><td>string</td><td>The product type</td><td>value_analysis</td> <td></td></tr> <tr><td>input_params.include_comp_based_analysis</td><td>string</td><td>Whether to include comp-based analysis was included in the request</td><td>true</td> <td>[true, false]</td></tr> <tr><td>input_params.zipcode</td><td>string</td><td>The zipcode</td><td>85020</td> <td></td></tr> <tr><td>input_params.street_address</td><td>string</td><td>Building number, street name and unit number</td><td>123 Main St</td> <td></td></tr> <tr><td>input_params.estimated_value</td><td>string</td><td>Outside estimate of the property’s value, maybe from a BPO or previous appraised value</td><td>320000</td> <td></td></tr> <tr><td>input_params.gla_sqft</td><td>string</td><td>Gross living area of property in square feet</td><td>2750</td> <td></td></tr> <tr><td>recommended_approach</td><td>string</td><td>HouseCanary’s suggested course of action to determine the value of the property with high confidence. One of: <pre>[No exceptions - Automate, Minor exceptions - Human review, Major exceptions - Onsite review]</pre></td><td>Minor exceptions - Human review</td> <td></td></tr> <tr><td>hc_avm_value_analysis</td><td>object</td><td>How HouseCanary’s AVM for the property relates to the area</td><td></td> <td></td></tr> <tr><td>hc_avm_value_analysis.avm_value</td><td>integer</td><td>HouseCanary automated value model for the property</td><td>1801218</td> <td></td></tr> <tr><td>hc_avm_value_analysis.avm_confidence</td><td>string</td><td>Confidence of the HouseCanary AVM for the property</td><td>high</td> <td>[low, medium, high]</td></tr> <tr><td>hc_avm_value_analysis.avm_fsd</td><td>number</td><td>Forecast standard deviation (FSD) for the AVM value, representing the model’s confidence. Lower values indicate higher confidence in the AVM estimate.</td><td>0.1414001</td> <td></td></tr> <tr><td>hc_avm_value_analysis.neighborhood_analysis</td><td>object</td><td>Details about housing stock in the census blockgroup containing the property</td><td></td> <td></td></tr> <tr><td>hc_avm_value_analysis.neighborhood_analysis.avm_value_sqft</td><td>integer</td><td>Value per square foot</td><td>987</td> <td></td></tr> <tr><td>hc_avm_value_analysis.neighborhood_analysis.5th_percentile_value_per_sqft</td><td>number</td><td>5th percentile of the range of property values in the area (i.e. low end of value range)</td><td>578.1</td> <td></td></tr> <tr><td>hc_avm_value_analysis.neighborhood_analysis.95th_percentile_value_per_sqft</td><td>number</td><td>95th percentile of the range of property values in the area (i.e. high end of value range)</td><td>988.7</td> <td></td></tr> <tr><td>hc_avm_value_analysis.neighborhood_analysis.within_neighborhood_norms</td><td>boolean</td><td><code>true</code> if the value falls between the 5th and 95th percentile of neighborhood values, <code>false</code> otherwise</td><td>true</td> <td></td></tr> <tr><td>hc_avm_value_analysis.comp_based_analysis</td><td>object</td><td>Feasibility of the property value based on comparable properties (adjusted by GLA)</td><td></td> <td></td></tr> <tr><td>hc_avm_value_analysis.comp_based_analysis.comp_fsd</td><td>number</td><td>Forecast standard deviation (FSD) for the comparable-based valuation, indicating the model’s confidence. Lower values suggest higher confidence in the comp-based estimate.</td><td>0.131</td> <td></td></tr> <tr><td>hc_avm_value_analysis.comp_based_analysis.number_of_comps</td><td>integer</td><td>Number of high similarity comparable properties included in the analysis</td><td>15</td> <td></td></tr> <tr><td>hc_avm_value_analysis.comp_based_analysis.5th_percentile_adjusted_comp_value</td><td>integer</td><td>5th percentile of the range of property values for adjusted comparable properties (i.e. low end of value range)</td><td>1134796</td> <td></td></tr> <tr><td>hc_avm_value_analysis.comp_based_analysis.95th_percentile_adjusted_comp_value</td><td>integer</td><td>95th percentile of the range of property values for adjusted comparable properties (i.e. high end of value range)</td><td>1734155</td> <td></td></tr> <tr><td>hc_avm_value_analysis.comp_based_analysis.avm_value_percentile_in_adjusted_comp_values</td><td>number</td><td>Where the percentile ranking of the value lies in the distribution of adjusted comp prices</td><td>96.5</td> <td></td></tr> <tr><td>hc_avm_value_analysis.comp_based_analysis.within_adjusted_comp_values</td><td>boolean</td><td><code>true</code> if the value falls between the 5th and 95th percentile of adjusted comp values, <code>false</code> otherwise</td><td>true</td> <td></td></tr> </table>get/v2/property/value_analysis
Query parameters
slugstring
A single URL-safe string identifying the address (obtained from HouseCanary)
street_addressstring
Building number, street name and unit number
zipcodeinteger
5-digit ZIP code
estimated_valueinteger
Outside estimate of the property’s value, maybe from a BPO or previous appraised value
gla_sqftinteger
Gross living area of property in square feet
include_comp_based_analysisboolean
Whether to include comp-based analysis (response may be slower if included)
Response
Success
Example response
{
"checks": {
"All pre-analysis checks passed": true,
"Address is supported": true,
"Address is complete": true,
"Precise geocode is available for address": true,
"Property at address is of supported type": true,
"Census block group information is available": true,
"Enough information on neighborhood characteristics is available": true,
"Gross living area of property is available or provided as input": true,
"Comps available for analysis": true
},
"input_params": {
"slug": "1624-E-Dogwood-Ln-Gilbert-AZ-85295",
"product_type": "value_analysis",
"include_comp_based_analysis": "true",
"zipcode": "85020",
"street_address": "123 Main St",
"estimated_value": "320000",
"gla_sqft": "2750"
},
"recommended_approach": "Minor exceptions - Human review",
"hc_avm_value_analysis": {
"avm_value": 1801218,
"avm_confidence": "high",
"avm_fsd": 0.1414001,
"neighborhood_analysis": {
"avm_value_sqft": 987,
"5th_percentile_value_per_sqft": 578.1,
"95th_percentile_value_per_sqft": 988.7,
"within_neighborhood_norms": true
},
"comp_based_analysis": {
"comp_fsd": 0.131,
"number_of_comps": 15,
"5th_percentile_adjusted_comp_value": 1134796,
"95th_percentile_adjusted_comp_value": 1734155,
"avm_value_percentile_in_adjusted_comp_values": 96.5,
"within_adjusted_comp_values": true
}
}
}