Endpoint Playground

Try the US housing markets dataset item API

Test Crawlora's US housing markets dataset item API with realistic prefilled filters. Generate a cURL request, inspect stored structured JSON records, and open the full docs or pricing page when you are ready to integrate dataset search. Dataset Playground requests query indexed data and do not apply proxy routing.

Endpoint facts

Method: GET
API path: /datasets/housing-markets/items/{region_type}/{table_id}
Platform: Datasets
Auth: apiKey
Credits: 1 credit/request
Required params: region_type, table_id
Common optional params: period, property_type, history

US housing markets dataset item API documentation Datasets platform page Crawlora API pricing Try Stored Datasets List API Try Airbnb Markets Dataset Facets API Try Airbnb Markets Dataset Country API Try Nearby Airbnb Markets Dataset API Try Airbnb Markets Dataset Search API

Prefilled cURL

curl "https://api.crawlora.net/api/v1/datasets/housing-markets/items/<region_type>/<table_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

Request parameters visible to crawlers

Parameter	Type	Required	Description
region_type (path)	string	Yes	Region level enum: national, metro, county, city, zip
table_id (path)	integer	Yes	Redfin table id (the region's stable numeric id)
period	string	No	Exact period start date, YYYY-MM-DD; defaults to the latest period
property_type	string	No	Property type enum: All Residential, Single Family Residential, Condo/Co-op, Townhouse, Multi-Family (2-4 Unit), Single Units Only; defaults to All Residential
history	boolean	No	Return the full monthly series instead of a single period

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region_type": "zip",
    "region_type_id": 2,
    "table_id": 26097,
    "region": "Zip Code: 60616",
    "state": "Illinois",
    "state_code": "IL",
    "zip_code": "60616",
    "parent_metro": "Chicago, IL",
    "parent_metro_code": "16984",
    "property_type": "All Residential",
    "property_type_id": -1,
    "period_begin": "2026-03-01",
    "period_end": "2026-05-31",
    "is_latest": true,
    "median_sale_price": 340000,
    "median_sale_price_yoy": 0.062,
    "median_list_price": 349900,
    "homes_sold": 94,
    "inventory": 151,
    "median_dom": 38,
    "median_household_income": 91245,
    "income_geo_id": "860Z200US60616",
    "income_vintage": "acs2024_5yr",
    "price_to_income": 3.73,
    "salary_to_buy": 96581,
    "affordability_gap": 5336,
    "mortgage_rate_pct": 6.49,
    "source": "redfin_data_center",
    "run_id": "housing-20260711",
    "schema_version": 1
  }
}

Public Playground

Preview the endpoint before sending a live request

Sample responses, schemas, request previews, and code snippets are visible before sign in. Create an account when you are ready to save an API key and run authenticated requests.

Set up API key Endpoint docs

Endpoint

Choose one catalog endpoint for this request.

62 shown

Group

Method

Auth

Endpoint

GETapiKey1 credit/requestdatasets.housingMarketItemResponseDocDatasets

GET /datasets/housing-markets/items/{region_type}/{table_id}

Get a US housing market record from the dataset

Returns one housing-market record by region_type and Redfin table_id from dataset id enum value `housing-markets`. 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` (defaults to `All Residential`). `period` defaults to the most recent period on record. Pass `history=true` to get the full monthly series (a `{dataset, region_type, table_id, property_type, items}` envelope, sorted by period ascending) instead of a single record.

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

View docs

API key

API key required for live requests. Your key is only used to send requests from this Playground.

not configured

Active Playground key: not configured

Manage API keys in Console

Path parameters

region_type

requiredstring

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

requiredinteger

Redfin table id (the region's stable numeric id)

Add an API key to send a live request.

If an active API key is configured, Copy cURL includes it. Share links never include API keys.

View docs

Sample responseGET

Shown before your first request. Add an API key and send a request to see the live response, status, latency, and headers.

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region_type": "zip",
    "region_type_id": 2,
    "table_id": 26097,
    "region": "Zip Code: 60616",
    "state": "Illinois",
    "state_code": "IL",
    "zip_code": "60616",
    "parent_metro": "Chicago, IL",
    "parent_metro_code": "16984",
    "property_type": "All Residential",
    "property_type_id": -1,
    "period_begin": "2026-03-01",
    "period_end": "2026-05-31",
    "is_latest": true,
    "median_sale_price": 340000,
    "median_sale_price_yoy": 0.062,
    "median_list_price": 349900,
    "homes_sold": 94,
    "inventory": 151,
    "median_dom": 38,
    "median_household_income": 91245,
    "income_geo_id": "860Z200US60616",
    "income_vintage": "acs2024_5yr",
    "price_to_income": 3.73,
    "salary_to_buy": 96581,
    "affordability_gap": 5336,
    "mortgage_rate_pct": 6.49,
    "source": "redfin_data_center",
    "run_id": "housing-20260711",
    "schema_version": 1
  }
}

Endpoint details

Method: GET
Path: /datasets/housing-markets/items/{region_type}/{table_id}
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Datasets
Parameters: 6 documented fields

Request parameters

region_type:pathtable_id:pathperiod:queryproperty_type:queryhistory:queryx-api-key:header

Response schema fields

codedatadata.affordability_gapdata.avg_sale_to_listdata.citydata.homes_solddata.income_geo_iddata.income_vintagedata.inventorydata.is_latestdata.last_updateddata.list_price_to_income

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region_type": "zip",
    "region_type_id": 2,
    "table_id": 26097,
    "region": "Zip Code: 60616",
    "state": "Illinois",
    "state_code": "IL",
    "zip_code": "60616",
    "parent_metro": "Chicago, IL",
    "parent_metro_code": "16984",
    "property_type": "All Residential",
    "property_type_id": -1,
    "period_begin": "2026-03-01",
    "period_end": "2026-05-31",
    "is_latest": true,
    "median_sale_price": 340000,
    "median_sale_price_yoy": 0.062,
    "median_list_price": 349900,
    "homes_sold": 94,
    "inventory": 151,
    "median_dom": 38,
    "median_household_income": 91245,
    "income_geo_id": "860Z200US60616",
    "income_vintage": "acs2024_5yr",
    "price_to_income": 3.73,
    "salary_to_buy": 96581,
    "affordability_gap": 5336,
    "mortgage_rate_pct": 6.49,
    "source": "redfin_data_center",
    "run_id": "housing-20260711",
    "schema_version": 1
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/datasets/housing-markets/items/<region_type>/<table_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"

View endpoint docs Open platform page Browse all endpoints Pricing List stored scraped datasets Facet the Airbnb markets dataset Get an Airbnb market from the dataset Airbnb market density near a coordinate Search the Airbnb markets dataset

Try the US housing markets dataset item API

Request parameters visible to crawlers

Parameter	Type	Required	Description
region_type (path)	string	Yes	Region level enum: national, metro, county, city, zip
table_id (path)	integer	Yes	Redfin table id (the region's stable numeric id)
period	string	No	Exact period start date, YYYY-MM-DD; defaults to the latest period
property_type	string	No	Property type enum: All Residential, Single Family Residential, Condo/Co-op, Townhouse, Multi-Family (2-4 Unit), Single Units Only; defaults to All Residential
history	boolean	No	Return the full monthly series instead of a single period

Example JSON response

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region_type": "zip",
    "region_type_id": 2,
    "table_id": 26097,
    "region": "Zip Code: 60616",
    "state": "Illinois",
    "state_code": "IL",
    "zip_code": "60616",
    "parent_metro": "Chicago, IL",
    "parent_metro_code": "16984",
    "property_type": "All Residential",
    "property_type_id": -1,
    "period_begin": "2026-03-01",
    "period_end": "2026-05-31",
    "is_latest": true,
    "median_sale_price": 340000,
    "median_sale_price_yoy": 0.062,
    "median_list_price": 349900,
    "homes_sold": 94,
    "inventory": 151,
    "median_dom": 38,
    "median_household_income": 91245,
    "income_geo_id": "860Z200US60616",
    "income_vintage": "acs2024_5yr",
    "price_to_income": 3.73,
    "salary_to_buy": 96581,
    "affordability_gap": 5336,
    "mortgage_rate_pct": 6.49,
    "source": "redfin_data_center",
    "run_id": "housing-20260711",
    "schema_version": 1
  }
}

Get a US housing market record from the dataset

API key required. Paste a full key or rotate one from the API Keys page.

Set up API key

{ "code": 200, "msg": "OK", "data": { "region_type": "zip", "region_type_id": 2, "table_id": 26097, "region": "Zip Code: 60616", "state": "Illinois", "state_code": "IL", "zip_code": "60616", "parent_metro": "Chicago, IL", "parent_metro_code": "16984", "property_type": "All Residential", "property_type_id": -1, "period_begin": "2026-03-01", "period_end": "2026-05-31", "is_latest": true, "median_sale_price": 340000, "median_sale_price_yoy": 0.062, "median_list_price": 349900, "homes_sold": 94, "inventory": 151, "median_dom": 38, "median_household_income": 91245, "income_geo_id": "860Z200US60616", "income_vintage": "acs2024_5yr", "price_to_income": 3.73, "salary_to_buy": 96581, "affordability_gap": 5336, "mortgage_rate_pct": 6.49, "source": "redfin_data_center", "run_id": "housing-20260711", "schema_version": 1 } }

Endpoint details

Method: GET
Path: /datasets/housing-markets/items/{region_type}/{table_id}
Authentication: apiKey
Credit cost: 1 credit/request
Platform: Datasets
Parameters: 6 documented fields

Request parameters

region_type:pathtable_id:pathperiod:queryproperty_type:queryhistory:queryx-api-key:header

Response schema fields

codedatadata.affordability_gapdata.avg_sale_to_listdata.citydata.homes_solddata.income_geo_iddata.income_vintagedata.inventorydata.is_latestdata.last_updateddata.list_price_to_income

Sample response summary

{
  "code": 200,
  "msg": "OK",
  "data": {
    "region_type": "zip",
    "region_type_id": 2,
    "table_id": 26097,
    "region": "Zip Code: 60616",
    "state": "Illinois",
    "state_code": "IL",
    "zip_code": "60616",
    "parent_metro": "Chicago, IL",
    "parent_metro_code": "16984",
    "property_type": "All Residential",
    "property_type_id": -1,
    "period_begin": "2026-03-01",
    "period_end": "2026-05-31",
    "is_latest": true,
    "median_sale_price": 340000,
    "median_sale_price_yoy": 0.062,
    "median_list_price": 349900,
    "homes_sold": 94,
    "inventory": 151,
    "median_dom": 38,
    "median_household_income": 91245,
    "income_geo_id": "860Z200US60616",
    "income_vintage": "acs2024_5yr",
    "price_to_income": 3.73,
    "salary_to_buy": 96581,
    "affordability_gap": 5336,
    "mortgage_rate_pct": 6.49,
    "source": "redfin_data_center",
    "run_id": "housing-20260711",
    "schema_version": 1
  }
}

cURL example

curl "https://api.crawlora.net/api/v1/datasets/housing-markets/items/<region_type>/<table_id>" \
  -H "x-api-key: $CRAWLORA_API_KEY"