Datasets

Search the US housing markets dataset

Searches monthly Redfin housing-market statistics per region and property type since 2012, joined to Census ACS income for affordability metrics. region_type enum: national, metro, county, city, zip. property_type enum: All Residential, Single Family Residential, Condo/Co-op, Townhouse, Multi-Family (2-4 Unit), Single Units Only. Sort enum: relevance, price_desc, price_asc, list_price_desc, list_price_asc, price_to_income_desc, price_to_income_asc, salary_to_buy_desc, salary_to_buy_asc, dom_asc, dom_desc, inventory_desc, homes_sold_desc, period_desc. Use latest=true for the most recent period per region series. Billing: this search costs 1 credit per record returned, with a minimum of 2 (an empty result costs 2, a full page of 100 costs 100).

get/datasets/housing-markets/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/datasets/housing-markets/search
  • Auth: API key in header x-api-key

Query parameters

qstring

Full-text query over region name and city, max 256 characters

region_type'national' | 'metro' | 'county' | 'city' | 'zip'

Region level enum: national, metro, county, city, zip

state_codestring

Exact two-letter state code filter, e.g. CA

property_typestring

Property type enum: All Residential, Single Family Residential, Condo/Co-op, Townhouse, Multi-Family (2-4 Unit), Single Units Only

parent_metro_codestring

Exact parent metro (CBSA) code filter, e.g. 16980

zip_codestring

Exact zip code filter (zip-level rows only), e.g. 60616

periodstring

Exact period start date filter, YYYY-MM-DD

latestboolean

Filter for the most recent period per region and property type

min_median_sale_pricenumber

Minimum median sale price in USD

max_median_sale_pricenumber

Maximum median sale price in USD

min_median_list_pricenumber

Minimum median list price in USD

max_median_list_pricenumber

Maximum median list price in USD

min_price_to_incomenumber

Minimum price-to-income ratio

max_price_to_incomenumber

Maximum price-to-income ratio

min_salary_to_buyinteger

Minimum salary needed to buy in USD per year

max_salary_to_buyinteger

Maximum salary needed to buy in USD per year

min_median_domnumber

Minimum median days on market

max_median_domnumber

Maximum median days on market

min_inventoryinteger

Minimum active inventory

max_inventoryinteger

Maximum active inventory

min_homes_soldinteger

Minimum homes sold in the period

sort'relevance' | 'price_desc' | 'price_asc' | 'list_price_desc' | 'list_price_asc' | 'price_to_income_desc' | 'price_to_income_asc' | 'salary_to_buy_desc' | 'salary_to_buy_asc' | 'dom_asc' | 'dom_desc' | 'inventory_desc' | 'homes_sold_desc' | 'period_desc'

Sort enum: relevance, price_desc, price_asc, list_price_desc, list_price_asc, price_to_income_desc, price_to_income_asc, salary_to_buy_desc, salary_to_buy_asc, dom_asc, dom_desc, inventory_desc, homes_sold_desc, period_desc

pageinteger

Page number, defaults to 1

page_sizeinteger

Page size, defaults to 20 and maxes at 100; page * page_size must be <= 10000

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.