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>Query parameters
Unique readable string identifier for the property
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)
Unit number for the property, if needed and not already specified in the address string
City in which the property is located
2-letter acronym of the US state in which the property is located
5-digit US zipcode in which the property is located
Dollar value supplied by the caller, to position within the distribution of property values within the block.
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"
]
}
}
}
]