Property Level

Value within Census Block

Compare a property's value and value per sq ft within its block, providing context for local market positioning.

Source: HouseCanary

Pricing Tier: Basic

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>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> <tr><td>client_value</td><td>number</td><td>Dollar value supplied by the caller, to position within the distribution of property values within the block.</td><td>950000</td> </tr> <tr><td>client_value_sqft</td><td>number</td><td>Dollar value per sq ft supplied by the caller, to position within the distribution of property values per sq ft within the block.</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. Defaults to SFD.</td><td>TH</td> <td>[SFD, TH, CND, INC, MFH]</td></tr> <tr><td>housecanary_value_percentile_range</td><td>object</td><td>Percentile range information for the HouseCanary value.</td><td></td> <td></td></tr> <tr><td>housecanary_value_percentile_range.name</td><td>string</td><td>Name of the range.</td><td>80th Percentile</td> <td></td></tr> <tr><td>housecanary_value_percentile_range.high</td><td>integer</td><td>High percentile of the range.</td><td>400000</td> <td></td></tr> <tr><td>housecanary_value_percentile_range.low</td><td>integer</td><td>Low percentile of the range.</td><td>300000</td> <td></td></tr> <tr><td>housecanary_value_sqft_percentile_range</td><td>object</td><td>Percentile range information for the HouseCanary value per square foot.</td><td></td> <td></td></tr> <tr><td>housecanary_value_sqft_percentile_range.name</td><td>string</td><td>Name of the range.</td><td>70th Percentile</td> <td></td></tr> <tr><td>housecanary_value_sqft_percentile_range.high</td><td>integer</td><td>High percentile of the range.</td><td>300</td> <td></td></tr> <tr><td>housecanary_value_sqft_percentile_range.low</td><td>integer</td><td>Low percentile of the range.</td><td>200</td> <td></td></tr> <tr><td>client_value_percentile_range</td><td>object</td><td>Percentile range information for the client-provided value.</td><td></td> <td></td></tr> <tr><td>client_value_percentile_range.name</td><td>string</td><td>Name of the range.</td><td>50th Percentile</td> <td></td></tr> <tr><td>client_value_percentile_range.high</td><td>integer</td><td>High percentile of the range.</td><td>320000</td> <td></td></tr> <tr><td>client_value_percentile_range.low</td><td>integer</td><td>Low percentile of the range.</td><td>280000</td> <td></td></tr> <tr><td>client_value_sqft_percentile_range</td><td>object</td><td>Percentile range information for the client-provided value per square foot.</td><td></td> <td></td></tr> <tr><td>client_value_sqft_percentile_range.name</td><td>string</td><td>Name of the range.</td><td>60th Percentile</td> <td></td></tr> <tr><td>client_value_sqft_percentile_range.high</td><td>integer</td><td>High percentile of the range.</td><td>280</td> <td></td></tr> <tr><td>client_value_sqft_percentile_range.low</td><td>integer</td><td>Low percentile of the range.</td><td>240</td> <td></td></tr> </table>
get/v2/property/value_within_block

Query parameters

slugstring

Unique readable string identifier for the property

addressstring required

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)

unitstring

Unit number for the property, if needed and not already specified in the address string

citystring

City in which the property is located

statestring

2-letter acronym of the US state in which the property is located

zipcodestring

5-digit US zipcode in which the property is located

client_valuenumber nullable

Dollar value supplied by the caller, to position within the distribution of property values within the block.

client_value_sqftnumber nullable

Dollar value per sq ft supplied by the caller, to position within the distribution of property values per sq ft within the block.

Response

Success

Example response

[
  {
    "property/value_within_block": {
      "result": {
        "property_type": "TH",
        "housecanary_value_percentile_range": {
          "name": "80th Percentile",
          "high": 400000,
          "low": 300000
        },
        "housecanary_value_sqft_percentile_range": {
          "name": "70th Percentile",
          "high": 300,
          "low": 200
        },
        "client_value_percentile_range": {
          "name": "50th Percentile",
          "high": 320000,
          "low": 280000
        },
        "client_value_sqft_percentile_range": {
          "name": "60th Percentile",
          "high": 280,
          "low": 240
        }
      }
    },
    "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"
        ]
      }
    }
  }
]