Market

Get county market statistics

Retrieve real estate market statistics aggregated at the county level, including sale counts, median prices, and year-over-year changes. API key optional (county aggregates, no person-level fields): anonymous callers are rate-limited per IP at the free tier; a present but invalid key is a 401; keyed calls are metered.

get/api/v1/market/counties

Request

  • Base URL: https://propraven.com
  • URL: https://propraven.com/api/v1/market/counties
  • Auth: one of:
    • HTTP bearer
    • none

Query parameters

state_fipsstring
Example:37

Filter by state FIPS code.

min_salesinteger
Example:50

Minimum number of sales in the period to include a county.

quarterstring
Example:2025Q4

Exact quarter, e.g. 2025Q4; any other format is a 400.

sort'median_sale_price' | 'sale_count' | 'total_volume' | 'price_yoy_pct'

Sort column. The former spellings median_price and yoy_change are accepted as deprecated aliases; any other value is a 400.

order'asc' | 'desc'

Sort direction (case-insensitive); any other value is a 400.

limitinteger
offsetinteger

Response

County market stats returned.

totalinteger required
limitinteger required
offsetinteger required

Example response

{
  "data": [
    {
      "county_fips": "37183",
      "state_fips": "37",
      "county_name": "Wake",
      "quarter": "2025Q4",
      "sale_count": 3200,
      "state_abbr": "NC",
      "median_price": 385000,
      "avg_price": 425000,
      "yoy_change": 0.05,
      "avg_days_on_market": 28
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.