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

recommended_approachstring required

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>

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
    }
  }
}