Value Distribution From Address (Batch)

Examine the distribution of property values and per sq ft values within a block, with key summary statistics including max, min, mean, standard deviation, count, and various percentiles for a comprehensive market overview at the block level.

Source: HouseCanary

Pricing Tier: Premium

Updated: Monthly

Request Query Params

<table><tr><th>Property</th><th>Type</th><th>Description</th><th>Example</th><th>Enum Values</th></tr> <tr><td>property_type</td><td>string</td><td>Desired property type to aggregate. Defaults to SFD.</td><td></td> <td>[SFD, TH, CND, INC, MFH]</td></tr> </table>

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><th>Enum Values</th></tr> <tr><td>property_type</td><td>string</td><td>Type of property specified in the request. Defaults to SFD. One of [SFD, TH, CND, INC, MFH].</td><td>TH</td> <td>[SFD, TH, CND, INC, MFH]</td></tr> <tr><td>value_5</td><td>number</td><td>Price at the 5th percentile.</td><td>230000</td> <td></td></tr> <tr><td>value_25</td><td>number</td><td>Price at the 25th percentile.</td><td>260000</td> <td></td></tr> <tr><td>value_50</td><td>number</td><td>Median price.</td><td>290000</td> <td></td></tr> <tr><td>value_75</td><td>number</td><td>Price at the 75th percentile.</td><td>320000</td> <td></td></tr> <tr><td>value_95</td><td>number</td><td>Price at the 95th percentile.</td><td>360000</td> <td></td></tr> <tr><td>value_min</td><td>integer</td><td>Minimum price.</td><td>200000</td> <td></td></tr> <tr><td>value_max</td><td>integer</td><td>Maximum price.</td><td>400000</td> <td></td></tr> <tr><td>value_mean</td><td>number</td><td>Mean price.</td><td>300000</td> <td></td></tr> <tr><td>value_sd</td><td>number</td><td>Price standard deviation.</td><td>25000</td> <td></td></tr> <tr><td>value_count</td><td>integer</td><td>Number of properties analyzed for price distribution.</td><td>1000</td> <td></td></tr> <tr><td>value_sqft_5</td><td>number</td><td>Price per square foot at the 5th percentile.</td><td>150</td> <td></td></tr> <tr><td>value_sqft_25</td><td>number</td><td>Price per square foot at the 25th percentile.</td><td>170</td> <td></td></tr> <tr><td>value_sqft_50</td><td>number</td><td>Median price per square foot.</td><td>190</td> <td></td></tr> <tr><td>value_sqft_75</td><td>number</td><td>Price per square foot at the 75th percentile.</td><td>210</td> <td></td></tr> <tr><td>value_sqft_95</td><td>number</td><td>Price per square foot at the 95th percentile.</td><td>230</td> <td></td></tr> <tr><td>value_sqft_min</td><td>number</td><td>Minimum price per square foot.</td><td>130</td> <td></td></tr> <tr><td>value_sqft_max</td><td>number</td><td>Maximum price per square foot.</td><td>250</td> <td></td></tr> <tr><td>value_sqft_mean</td><td>number</td><td>Mean price per square foot.</td><td>180</td> <td></td></tr> <tr><td>value_sqft_sd</td><td>number</td><td>Price per square foot standard deviation.</td><td>20</td> <td></td></tr> <tr><td>value_sqft_count</td><td>integer</td><td>Number of properties analyzed for price per square foot distribution.</td><td>950</td> <td></td></tr> </table>

[
  {
    "slug": "123-Main-St-Apt-1B-San-Francisco-CA-94132",
    "address": "123 Main St",
    "unit": "Apt 1B",
    "city": "San Francisco",
    "state": "CA",
    "zipcode": "94105"
  }
]

[
  {
    "property/block_value_distribution": {
      "result": {
        "property_type": "TH",
        "value_5": 230000,
        "value_25": 260000,
        "value_50": 290000,
        "value_75": 320000,
        "value_95": 360000,
        "value_min": 200000,
        "value_max": 400000,
        "value_mean": 300000,
        "value_sd": 25000,
        "value_count": 1000,
        "value_sqft_5": 150,
        "value_sqft_25": 170,
        "value_sqft_50": 190,
        "value_sqft_75": 210,
        "value_sqft_95": 230,
        "value_sqft_min": 130,
        "value_sqft_max": 250,
        "value_sqft_mean": 180,
        "value_sqft_sd": 20,
        "value_sqft_count": 950
      }
    },
    "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"
        ]
      }
    }
  }
]