Zillow Research Home Value & Market Heat Scraper

Get US state-level home value trends, active-listing inventory, and metro-level market heat index data from Zillow's published research files. Filter by state and cap the number of records returned.

Open on Apify GitHub source

Input schema

Input fields, types, required flags, descriptions, defaults, and prefills come from the published definition. Prefill examples are distinct from defaults.

Field	Type	Required	Description
`mode`	string	required	What to return: latest values, full history, a multi-metric region snapshot, or the dataset catalog. The legacy options keep old saved tasks working with the previous wide output.
`dataset`	string	optional	Zillow Research file to read. Covers home values, rents, inventory, days on market, price cuts, sales, market heat, forecasts, new construction and affordability at the geography levels Zillow publishes.
`customDatasetUrl`	string	optional	Optional Zillow Research CSV URL (https://files.zillowstatic.com/research/...csv) for a dataset newer than this actor's catalog. Overrides Dataset.

Show all input fields

Field	Type	Required	Description
`mode`	string	required	What to return: latest values, full history, a multi-metric region snapshot, or the dataset catalog. The legacy options keep old saved tasks working with the previous wide output.
`dataset`	string	optional	Zillow Research file to read. Covers home values, rents, inventory, days on market, price cuts, sales, market heat, forecasts, new construction and affordability at the geography levels Zillow publishes.
`customDatasetUrl`	string	optional	Optional Zillow Research CSV URL (https://files.zillowstatic.com/research/...csv) for a dataset newer than this actor's catalog. Overrides Dataset.
`regions`	array	optional	Optional region names or substrings: 'Austin, TX', 'Texas', 'TX', '90210', 'Harris County'. Matches region, state, city, county and metro names. Leave empty for all regions.
`regionIds`	array	optional	Optional exact Zillow RegionIDs (for example 102001 for the United States). If both Regions and Region IDs are set, a row must match both.
`startDate`	string	optional	Optional inclusive start date in YYYY-MM-DD format. Omit for the earliest published date.
`endDate`	string	optional	Optional inclusive end date in YYYY-MM-DD format. Omit for the latest published date.
`includeChanges`	boolean	optional	Add 1-month, 3-month and 1-year percentage changes to latest and snapshot records when prior values exist.
`snapshotMetrics`	array	optional	Metrics to include in snapshot mode. Allowed values: zhvi, zori, inventory, newListings, medianListPrice, medianSalePrice, salesCount, daysToPending, priceCutShare, saleToListRatio, marketHeatIndex, newConstructionSales. Leave empty for all 12.
`category`	string	optional	Filter the dataset catalog in catalog mode. Ignored in other modes.
`maxItems`	integer	optional	Maximum number of records to return. Large ZIP or neighborhood histories need a date range, region filter, or a higher cap.

Download the published input schema

View complete JSON

{
  "description": "Download Zillow Research home values, rents, inventory, days to pending, price cuts, sales, market heat, forecasts, new construction and affordability data by US region.",
  "properties": {
    "category": {
      "default": "all",
      "description": "Filter the dataset catalog in catalog mode. Ignored in other modes.",
      "editor": "select",
      "enum": [
        "all",
        "Affordability",
        "Days on market and price cuts",
        "For-sale listings",
        "Home values",
        "Home values forecasts",
        "Market heat index",
        "New construction",
        "Rental forecasts",
        "Rentals",
        "Sales"
      ],
      "enumTitles": [
        "All datasets",
        "Affordability",
        "Days on market and price cuts",
        "For-sale listings",
        "Home values",
        "Home values forecasts",
        "Market heat index",
        "New construction",
        "Rental forecasts",
        "Rentals",
        "Sales"
      ],
      "prefill": "all",
      "title": "Catalog category",
      "type": "string"
    },
    "customDatasetUrl": {
      "description": "Optional Zillow Research CSV URL (https://files.zillowstatic.com/research/...csv) for a dataset newer than this actor's catalog. Overrides Dataset.",
      "editor": "textfield",
      "title": "Custom dataset URL (advanced)",
      "type": "string"
    },
    "dataset": {
      "default": "market_temp_index_metro_uc_sfrcondo_month",
      "description": "Zillow Research file to read. Covers home values, rents, inventory, days on market, price cuts, sales, market heat, forecasts, new construction and affordability at the geography levels Zillow publishes.",
      "editor": "select",
      "enum": [
        "affordable_price_metro_downpayment_0_20_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "new_homeowner_affordability_metro_downpayment_0_20_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "new_homeowner_income_needed_metro_downpayment_0_20_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "new_renter_affordability_metro_uc_sfrcondomfr_sm_sa_month",
        "new_renter_income_needed_metro_uc_sfrcondomfr_sm_sa_month",
        "years_to_save_metro_downpayment_0_20_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "mean_days_to_close_metro_uc_sfrcondo_month",
        "mean_days_to_close_metro_uc_sfrcondo_sm_month",
        "mean_days_to_close_metro_uc_sfrcondo_sm_week",
        "mean_days_to_close_metro_uc_sfrcondo_week",
        "mean_doz_pending_metro_uc_sfrcondo_month",
        "mean_doz_pending_metro_uc_sfrcondo_sm_month",
        "mean_doz_pending_metro_uc_sfrcondo_sm_week",
        "mean_doz_pending_metro_uc_sfrcondo_week",
        "mean_listings_price_cut_amt_metro_uc_sfr_month",
        "mean_listings_price_cut_amt_metro_uc_sfr_sm_month",
        "mean_listings_price_cut_amt_metro_uc_sfr_sm_week",
        "mean_listings_price_cut_amt_metro_uc_sfr_week",
        "mean_listings_price_cut_amt_metro_uc_sfrcondo_month",
        "mean_listings_price_cut_amt_metro_uc_sfrcondo_sm_month",
        "mean_listings_price_cut_amt_metro_uc_sfrcondo_sm_week",
        "mean_listings_price_cut_amt_metro_uc_sfrcondo_week",
        "mean_listings_price_cut_perc_metro_uc_sfr_month",
        "mean_listings_price_cut_perc_metro_uc_sfr_week",
        "mean_listings_price_cut_perc_metro_uc_sfrcondo_month",
        "mean_listings_price_cut_perc_metro_uc_sfrcondo_sm_month",
        "mean_listings_price_cut_perc_metro_uc_sfrcondo_sm_week",
        "mean_listings_price_cut_perc_metro_uc_sfrcondo_week",
        "med_doz_pending_metro_uc_sfrcondo_month",
        "med_doz_pending_metro_uc_sfrcondo_sm_month",
        "med_doz_pending_metro_uc_sfrcondo_sm_week",
        "med_doz_pending_metro_uc_sfrcondo_week",
        "med_listings_price_cut_amt_metro_uc_sfr_month",
        "med_listings_price_cut_amt_metro_uc_sfr_sm_month",
        "med_listings_price_cut_amt_metro_uc_sfr_sm_week",
        "med_listings_price_cut_amt_metro_uc_sfr_week",
        "med_listings_price_cut_amt_metro_uc_sfrcondo_month",
        "med_listings_price_cut_amt_metro_uc_sfrcondo_sm_month",
        "med_listings_price_cut_amt_metro_uc_sfrcondo_sm_week",
        "med_listings_price_cut_amt_metro_uc_sfrcondo_week",
        "med_listings_price_cut_perc_metro_uc_sfr_month",
        "med_listings_price_cut_perc_metro_uc_sfr_sm_month",
        "med_listings_price_cut_perc_metro_uc_sfr_sm_week",
        "med_listings_price_cut_perc_metro_uc_sfr_week",
        "med_listings_price_cut_perc_metro_uc_sfrcondo_month",
        "med_listings_price_cut_perc_metro_uc_sfrcondo_sm_month",
        "med_listings_price_cut_perc_metro_uc_sfrcondo_sm_week",
        "med_listings_price_cut_perc_metro_uc_sfrcondo_week",
        "median_days_to_close_metro_uc_sfrcondo_month",
        "median_days_to_close_metro_uc_sfrcondo_sm_month",
        "median_days_to_close_metro_uc_sfrcondo_sm_week",
        "median_days_to_close_metro_uc_sfrcondo_week",
        "perc_listings_price_cut_metro_uc_sfr_month",
        "perc_listings_price_cut_metro_uc_sfr_sm_month",
        "perc_listings_price_cut_metro_uc_sfr_sm_week",
        "perc_listings_price_cut_metro_uc_sfr_week",
        "perc_listings_price_cut_metro_uc_sfrcondo_month",
        "perc_listings_price_cut_metro_uc_sfrcondo_sm_month",
        "perc_listings_price_cut_metro_uc_sfrcondo_sm_week",
        "perc_listings_price_cut_metro_uc_sfrcondo_week",
        "invt_fs_metro_uc_sfr_month",
        "invt_fs_metro_uc_sfr_sm_month",
        "invt_fs_metro_uc_sfr_sm_week",
        "invt_fs_metro_uc_sfr_week",
        "invt_fs_metro_uc_sfrcondo_month",
        "invt_fs_metro_uc_sfrcondo_sm_month",
        "invt_fs_metro_uc_sfrcondo_sm_week",
        "invt_fs_metro_uc_sfrcondo_week",
        "mlp_metro_uc_sfr_month",
        "mlp_metro_uc_sfr_sm_month",
        "mlp_metro_uc_sfr_sm_week",
        "mlp_metro_uc_sfr_week",
        "mlp_metro_uc_sfrcondo_month",
        "mlp_metro_uc_sfrcondo_sm_month",
        "mlp_metro_uc_sfrcondo_sm_week",
        "mlp_metro_uc_sfrcondo_week",
        "new_listings_metro_uc_sfrcondo_month",
        "new_listings_metro_uc_sfrcondo_sm_month",
        "new_listings_metro_uc_sfrcondo_sm_week",
        "new_listings_metro_uc_sfrcondo_week",
        "new_pending_metro_uc_sfrcondo_month",
        "new_pending_metro_uc_sfrcondo_sm_month",
        "new_pending_metro_uc_sfrcondo_sm_week",
        "new_pending_metro_uc_sfrcondo_week",
        "mortgage_payment_metro_downpayment_0_05_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "mortgage_payment_metro_downpayment_0_10_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "mortgage_payment_metro_downpayment_0_20_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "total_monthly_payment_metro_downpayment_0_05_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "total_monthly_payment_metro_downpayment_0_10_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "total_monthly_payment_metro_downpayment_0_20_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_bdrmcnt_1_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_bdrmcnt_2_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_bdrmcnt_3_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_bdrmcnt_4_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_bdrmcnt_5_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_uc_condo_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_uc_sfr_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_uc_sfrcondo_tier_0_0_0_33_sm_sa_month",
        "zhvi_city_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_city_uc_sfrcondo_tier_0_67_1_0_sm_sa_month",
        "zhvi_county_bdrmcnt_1_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_county_bdrmcnt_2_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_county_bdrmcnt_3_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_county_bdrmcnt_4_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_county_bdrmcnt_5_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_county_uc_condo_tier_0_33_0_67_sm_sa_month",
        "zhvi_county_uc_sfr_tier_0_33_0_67_sm_sa_month",
        "zhvi_county_uc_sfrcondo_tier_0_0_0_33_sm_sa_month",
        "zhvi_county_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_county_uc_sfrcondo_tier_0_67_1_0_sm_sa_month",
        "zhvi_metro_bdrmcnt_1_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_metro_bdrmcnt_2_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_metro_bdrmcnt_3_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_metro_bdrmcnt_4_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_metro_bdrmcnt_5_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_metro_uc_condo_tier_0_33_0_67_sm_sa_month",
        "zhvi_metro_uc_sfr_tier_0_33_0_67_sm_sa_month",
        "zhvi_metro_uc_sfrcondo_tier_0_0_0_33_sm_sa_month",
        "zhvi_metro_uc_sfrcondo_tier_0_33_0_67_month",
        "zhvi_metro_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_metro_uc_sfrcondo_tier_0_67_1_0_sm_sa_month",
        "zhvi_neighborhood_bdrmcnt_1_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_neighborhood_bdrmcnt_2_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_neighborhood_bdrmcnt_3_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_neighborhood_bdrmcnt_4_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_neighborhood_bdrmcnt_5_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_neighborhood_uc_condo_tier_0_33_0_67_sm_sa_month",
        "zhvi_neighborhood_uc_sfr_sm_sa_month",
        "zhvi_neighborhood_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_bdrmcnt_1_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_bdrmcnt_2_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_bdrmcnt_3_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_bdrmcnt_4_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_bdrmcnt_5_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_uc_condo_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_uc_sfr_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_uc_sfrcondo_tier_0_0_0_33_sm_sa_month",
        "zhvi_state_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_state_uc_sfrcondo_tier_0_67_1_0_sm_sa_month",
        "zhvi_zip_bdrmcnt_1_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_zip_bdrmcnt_2_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_zip_bdrmcnt_3_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_zip_bdrmcnt_4_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_zip_bdrmcnt_5_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvi_zip_uc_condo_tier_0_33_0_67_sm_sa_month",
        "zhvi_zip_uc_sfr_tier_0_33_0_67_sm_sa_month",
        "zhvi_zip_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvf_growth_metro_uc_sfrcondo_tier_0_33_0_67_month",
        "zhvf_growth_metro_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "zhvf_growth_zip_uc_sfrcondo_tier_0_33_0_67_month",
        "zhvf_growth_zip_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
        "market_temp_index_metro_uc_sfrcondo_month",
        "new_con_mean_sale_price_metro_uc_sfrcondo_month",
        "new_con_median_sale_price_metro_uc_sfrcondo_month",
        "new_con_median_sale_price_per_sqft_metro_uc_sfrcondo_month",
        "new_con_sales_count_raw_metro_uc_sfrcondo_month",
        "zorf_growth_us_national_zorf_growth_uc_mfr_sm_month",
        "zorf_growth_us_national_zorf_growth_uc_sfr_sm_month",
        "zordi_metro_uc_condo_month",
        "zordi_metro_uc_mfr_month",
        "zordi_metro_uc_sfr_month",
        "zordi_metro_uc_sfrcondomfr_month",
        "zori_city_uc_sfrcondomfr_sm_month",
        "zori_city_uc_sfrcondomfr_sm_sa_month",
        "zori_county_uc_sfrcondomfr_sm_month",
        "zori_county_uc_sfrcondomfr_sm_sa_month",
        "zori_metro_uc_mfr_sm_month",
        "zori_metro_uc_mfr_sm_sa_month",
        "zori_metro_uc_sfr_sm_month",
        "zori_metro_uc_sfr_sm_sa_month",
        "zori_metro_uc_sfrcondomfr_sm_month",
        "zori_metro_uc_sfrcondomfr_sm_sa_month",
        "zori_zip_uc_sfrcondomfr_sm_month",
        "zori_zip_uc_sfrcondomfr_sm_sa_month",
        "mean_sale_price_metro_uc_sfr_month",
        "mean_sale_price_metro_uc_sfr_sm_month",
        "mean_sale_price_metro_uc_sfr_sm_sa_week",
        "mean_sale_price_metro_uc_sfr_sm_week",
        "mean_sale_price_metro_uc_sfrcondo_sm_week",
        "mean_sale_price_now_metro_uc_sfrcondo_month",
        "mean_sale_to_list_metro_uc_sfrcondo_month",
        "mean_sale_to_list_metro_uc_sfrcondo_sm_month",
        "mean_sale_to_list_metro_uc_sfrcondo_sm_week",
        "mean_sale_to_list_metro_uc_sfrcondo_week",
        "median_sale_price_metro_uc_sfr_month",
        "median_sale_price_metro_uc_sfr_sm_week",
        "median_sale_price_metro_uc_sfrcondo_sm_week",
        "median_sale_price_now_metro_uc_sfrcondo_month",
        "median_sale_to_list_metro_uc_sfrcondo_month",
        "median_sale_to_list_metro_uc_sfrcondo_sm_month",
        "median_sale_to_list_metro_uc_sfrcondo_sm_week",
        "median_sale_to_list_metro_uc_sfrcondo_week",
        "pct_sold_above_list_metro_uc_sfrcondo_month",
        "pct_sold_above_list_metro_uc_sfrcondo_sm_month",
        "pct_sold_above_list_metro_uc_sfrcondo_sm_week",
        "pct_sold_above_list_metro_uc_sfrcondo_week",
        "pct_sold_below_list_metro_uc_sfrcondo_month",
        "pct_sold_below_list_metro_uc_sfrcondo_sm_month",
        "pct_sold_below_list_metro_uc_sfrcondo_sm_week",
        "pct_sold_below_list_metro_uc_sfrcondo_week",
        "sales_count_now_metro_uc_sfrcondo_month",
        "sales_count_raw_metro_uc_sfr_month",
        "sales_count_raw_metro_uc_sfr_sm_week",
        "sales_count_raw_metro_uc_sfrcondo_sm_week",
        "total_transaction_value_metro_uc_sfr_month",
        "total_transaction_value_metro_uc_sfr_sm_week",
        "total_transaction_value_metro_uc_sfrcondo_sm_week",
        "total_transaction_value_now_metro_uc_sfrcondo_month"
      ],
      "enumTitles": [
        "Affordability · Affordable Home Price: 20% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Affordability · New Homeowner Affordability: 20% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Affordability · New Homeowner Income Needed: 20% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Affordability · New Renter Affordability: All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Affordability · New Renter Income Needed: All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Affordability · Years to Save: 20% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Days on market and price cuts · Mean Days to Close (Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Mean Days to Close (Smooth, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Mean Days to Close (Smooth, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Mean Days to Close (Raw, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Mean Days to Pending (Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Mean Days to Pending (Smooth, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Mean Days to Pending (Smooth, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Mean Days to Pending (Raw, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Mean Price Cut ($, Raw, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Mean Price Cut ($, Smoothed, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Mean Price Cut ($, Smoothed, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Mean Price Cut ($, Raw, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Mean Price Cut ($, Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Mean Price Cut ($, Smoothed, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Mean Price Cut ($, Smoothed, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Mean Price Cut ($, Raw, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Mean Price Cut (%, Raw, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Mean Price Cut (%, Raw, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Mean Price Cut (%, Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Mean Price Cut (%, Smoothed, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Mean Price Cut (%, Smoothed, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Mean Price Cut (%, Raw, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Median Days to Pending (Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Median Days to Pending (Smooth, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Median Days to Pending (Smooth, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Median Days to Pending (Raw, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Median Price Cut ($, Raw, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Median Price Cut ($, Smoothed, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Median Price Cut ($, Smoothed, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Median Price Cut ($, Raw, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Median Price Cut ($, Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Median Price Cut ($, Smoothed, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Median Price Cut ($, Smoothed, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Median Price Cut ($, Raw, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Median Price Cut (%, Raw, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Median Price Cut (%, Smoothed, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Median Price Cut (%, Smoothed, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Median Price Cut (%, Raw, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Median Price Cut (%, Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Median Price Cut (%, Smoothed, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Median Price Cut (%, Smoothed, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Median Price Cut (%, Raw, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Median Days to Close (Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Median Days to Close (Smooth, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Median Days to Close (Smooth, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Median Days to Close (Raw, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Share of Listings With a Price Cut (Raw, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Share of Listings With a Price Cut (Smooth, SFR Only, Monthly) · Metro",
        "Days on market and price cuts · Share of Listings With a Price Cut (Smooth, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Share of Listings With a Price Cut (Raw, SFR Only, Weekly) · Metro",
        "Days on market and price cuts · Share of Listings With a Price Cut (Raw, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Share of Listings With a Price Cut (Smooth, All Homes, Monthly) · Metro",
        "Days on market and price cuts · Share of Listings With a Price Cut (Smooth, All Homes, Weekly) · Metro",
        "Days on market and price cuts · Share of Listings With a Price Cut (Raw, All Homes, Weekly) · Metro",
        "For-sale listings · For-Sale Inventory (Raw, SFR Only, Monthly) · Metro",
        "For-sale listings · For-Sale Inventory (Smooth, SFR Only, Monthly) · Metro",
        "For-sale listings · For-Sale Inventory (Smooth, SFR Only, Weekly) · Metro",
        "For-sale listings · For-Sale Inventory (Raw, SFR Only, Weekly) · Metro",
        "For-sale listings · For-Sale Inventory (Raw, All Homes, Monthly) · Metro",
        "For-sale listings · For-Sale Inventory (Smooth, All Homes, Monthly) · Metro",
        "For-sale listings · For-Sale Inventory (Smooth, All Homes, Weekly) · Metro",
        "For-sale listings · For-Sale Inventory (Raw, All Homes, Weekly) · Metro",
        "For-sale listings · Median List Price (Raw, SFR Only, Monthly) · Metro",
        "For-sale listings · Median List Price (Smooth, SFR Only, Monthly) · Metro",
        "For-sale listings · Median List Price (Smooth, SFR Only, Weekly) · Metro",
        "For-sale listings · Median List Price (Raw, SFR Only, Weekly) · Metro",
        "For-sale listings · Median List Price (Raw, All Homes, Monthly) · Metro",
        "For-sale listings · Median List Price (Smooth, All Homes, Monthly) · Metro",
        "For-sale listings · Median List Price (Smooth, All Homes, Weekly) · Metro",
        "For-sale listings · Median List Price (Raw, All Homes, Weekly) · Metro",
        "For-sale listings · New Listings (Raw, All Homes, Monthly) · Metro",
        "For-sale listings · New Listings (Smooth, All Homes, Monthly) · Metro",
        "For-sale listings · New Listings (Smooth, All Homes, Weekly) · Metro",
        "For-sale listings · New Listings (Raw, All Homes, Weekly) · Metro",
        "For-sale listings · Newly Pending Listings (Raw, All Homes, Monthly) · Metro",
        "For-sale listings · Newly Pending Listings (Smoothed, All Homes, Monthly) · Metro",
        "For-sale listings · Newly Pending Listings (Smoothed, All Homes, Weekly) · Metro",
        "For-sale listings · Newly Pending Listings (Raw, All Homes, Weekly) · Metro",
        "Home values · Mortgage Payment: 5% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Home values · Mortgage Payment: 10% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Home values · Mortgage Payment: 20% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Home values · Total Monthly Payment: 5% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Home values · Total Monthly Payment: 10% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Home values · Total Monthly Payment: 20% down, All Homes, Smoothed & Seasonally Adjusted Time Series · Metro",
        "Home values · ZHVI 1-Bedroom Time Series ($) · City",
        "Home values · ZHVI 2-Bedroom Time Series ($) · City",
        "Home values · ZHVI 3-Bedroom Time Series ($) · City",
        "Home values · ZHVI 4-Bedroom Time Series ($) · City",
        "Home values · ZHVI 5+ Bedroom Time Series ($) · City",
        "Home values · ZHVI Condo/Co-op Time Series ($) · City",
        "Home values · ZHVI Single-Family Homes Time Series ($) · City",
        "Home values · ZHVI All Homes- Bottom Tier Time Series ($) · City",
        "Home values · ZHVI All Homes (SFR, Condo/Co-op) Time Series, Smoothed, Seasonally Adjusted($) · City",
        "Home values · ZHVI All Homes- Top Tier Time Series ($) · City",
        "Home values · ZHVI 1-Bedroom Time Series ($) · County",
        "Home values · ZHVI 2-Bedroom Time Series ($) · County",
        "Home values · ZHVI 3-Bedroom Time Series ($) · County",
        "Home values · ZHVI 4-Bedroom Time Series ($) · County",
        "Home values · ZHVI 5+ Bedroom Time Series ($) · County",
        "Home values · ZHVI Condo/Co-op Time Series ($) · County",
        "Home values · ZHVI Single-Family Homes Time Series ($) · County",
        "Home values · ZHVI All Homes- Bottom Tier Time Series ($) · County",
        "Home values · ZHVI All Homes (SFR, Condo/Co-op) Time Series, Smoothed, Seasonally Adjusted($) · County",
        "Home values · ZHVI All Homes- Top Tier Time Series ($) · County",
        "Home values · ZHVI 1-Bedroom Time Series ($) · Metro",
        "Home values · ZHVI 2-Bedroom Time Series ($) · Metro",
        "Home values · ZHVI 3-Bedroom Time Series ($) · Metro",
        "Home values · ZHVI 4-Bedroom Time Series ($) · Metro",
        "Home values · ZHVI 5+ Bedroom Time Series ($) · Metro",
        "Home values · ZHVI Condo/Co-op Time Series ($) · Metro",
        "Home values · ZHVI Single-Family Homes Time Series ($) · Metro",
        "Home values · ZHVI All Homes- Bottom Tier Time Series ($) · Metro",
        "Home values · ZHVI All Homes (SFR, Condo/Co-op) Time Series, Raw, Mid-Tier ($) · Metro",
        "Home values · ZHVI All Homes (SFR, Condo/Co-op) Time Series, Smoothed, Seasonally Adjusted($) · Metro",
        "Home values · ZHVI All Homes- Top Tier Time Series ($) · Metro",
        "Home values · ZHVI 1-Bedroom Time Series ($) · Neighborhood",
        "Home values · ZHVI 2-Bedroom Time Series ($) · Neighborhood",
        "Home values · ZHVI 3-Bedroom Time Series ($) · Neighborhood",
        "Home values · ZHVI 4-Bedroom Time Series ($) · Neighborhood",
        "Home values · ZHVI 5+ Bedroom Time Series ($) · Neighborhood",
        "Home values · ZHVI Condo/Co-op Time Series ($) · Neighborhood",
        "Home values · ZHVI Single-Family Homes Time Series ($) · Neighborhood",
        "Home values · ZHVI All Homes (SFR, Condo/Co-op) Time Series, Smoothed, Seasonally Adjusted($) · Neighborhood",
        "Home values · ZHVI 1-Bedroom Time Series ($) · State",
        "Home values · ZHVI 2-Bedroom Time Series ($) · State",
        "Home values · ZHVI 3-Bedroom Time Series ($) · State",
        "Home values · ZHVI 4-Bedroom Time Series ($) · State",
        "Home values · ZHVI 5+ Bedroom Time Series ($) · State",
        "Home values · ZHVI Condo/Co-op Time Series ($) · State",
        "Home values · ZHVI Single-Family Homes Time Series ($) · State",
        "Home values · ZHVI All Homes- Bottom Tier Time Series ($) · State",
        "Home values · ZHVI All Homes (SFR, Condo/Co-op) Time Series, Smoothed, Seasonally Adjusted($) · State",
        "Home values · ZHVI All Homes- Top Tier Time Series ($) · State",
        "Home values · ZHVI 1-Bedroom Time Series ($) · ZIP",
        "Home values · ZHVI 2-Bedroom Time Series ($) · ZIP",
        "Home values · ZHVI 3-Bedroom Time Series ($) · ZIP",
        "Home values · ZHVI 4-Bedroom Time Series ($) · ZIP",
        "Home values · ZHVI 5+ Bedroom Time Series ($) · ZIP",
        "Home values · ZHVI Condo/Co-op Time Series ($) · ZIP",
        "Home values · ZHVI Single-Family Homes Time Series ($) · ZIP",
        "Home values · ZHVI All Homes (SFR, Condo/Co-op) Time Series, Smoothed, Seasonally Adjusted($) · ZIP",
        "Home values forecasts · ZHVF (Forecast), All Homes (SFR, Condo/Co-op), Raw, Mid-Tier (MoM%, QoQ%, YoY%) · Metro",
        "Home values forecasts · ZHVF (Forecast), All Homes (SFR, Condo/Co-op), Smoothed, Seasonally Adjusted, Mid-Tier (MoM%, QoQ%, YoY%) · Metro",
        "Home values forecasts · ZHVF (Forecast), All Homes (SFR, Condo/Co-op), Raw, Mid-Tier (MoM%, QoQ%, YoY%) · ZIP",
        "Home values forecasts · ZHVF (Forecast), All Homes (SFR, Condo/Co-op), Smoothed, Seasonally Adjusted, Mid-Tier (MoM%, QoQ%, YoY%) · ZIP",
        "Market heat index · Market Heat Index (All Homes, Monthly) · Metro",
        "New construction · New Construction Mean Sale Price (Raw, All Homes, Monthly) · Metro",
        "New construction · New Construction Median Sale Price (Raw, All Homes, Monthly) · Metro",
        "New construction · New Construction Median Sale Price Per Square Foot (Raw, All Homes, Monthly) · Metro",
        "New construction · New Construction Sales Count (Raw, All Homes, Monthly) · Metro",
        "Rental forecasts · ZORF, (Multi Family Residence, Smoothed) · US",
        "Rental forecasts · ZORF, (Single Family Residence, Smoothed) · US",
        "Rentals · ZORDI: Condo/Co-op Time Series · Metro",
        "Rentals · ZORDI: Multifamily Residence Time Series · Metro",
        "Rentals · ZORDI: Single Family Residence Time Series · Metro",
        "Rentals · ZORDI: All Homes Plus Multifamily Time Series · Metro",
        "Rentals · ZORI (Smoothed): All Homes Plus Multifamily Time Series ($) · City",
        "Rentals · ZORI (Smoothed, Seasonally Adjusted): All Homes Plus Multifamily Time Series ($) · City",
        "Rentals · ZORI (Smoothed): All Homes Plus Multifamily Time Series ($) · County",
        "Rentals · ZORI (Smoothed, Seasonally Adjusted): All Homes Plus Multifamily Time Series ($) · County",
        "Rentals · ZORI (Smoothed): Multi Family Residence Time Series ($) · Metro",
        "Rentals · ZORI (Smoothed, Seasonally Adjusted): Multi Family Residence Time Series ($) · Metro",
        "Rentals · ZORI (Smoothed): Single Family Residence Time Series ($) · Metro",
        "Rentals · ZORI (Smoothed, Seasonally Adjusted): Single Family Residence Time Series ($) · Metro",
        "Rentals · ZORI (Smoothed): All Homes Plus Multifamily Time Series ($) · Metro",
        "Rentals · ZORI (Smoothed, Seasonally Adjusted): All Homes Plus Multifamily Time Series ($) · Metro",
        "Rentals · ZORI (Smoothed): All Homes Plus Multifamily Time Series ($) · ZIP",
        "Rentals · ZORI (Smoothed, Seasonally Adjusted): All Homes Plus Multifamily Time Series ($) · ZIP",
        "Sales · Mean Sale Price (Raw, SFR only, Monthly) · Metro",
        "Sales · Mean Sale Price (Smooth & Seasonally Adjusted, SFR only, Monthly) · Metro",
        "Sales · Mean Sale Price (Smooth & Seasonally Adjusted, SFR only, Weekly) · Metro",
        "Sales · Mean Sale Price (Smooth, SFR only, Weekly) · Metro",
        "Sales · Mean Sale Price (Smooth, All Homes, Weekly) · Metro",
        "Sales · Mean Sale Price (Nowcast, All Homes, Monthly) · Metro",
        "Sales · Mean Sale-to-List Ratio (Raw, All Homes, Monthly) · Metro",
        "Sales · Mean Sale-to-List Ratio (Smooth, All Homes, Monthly) · Metro",
        "Sales · Mean Sale-to-List Ratio (Smooth, All Homes, Weekly) · Metro",
        "Sales · Mean Sale-to-List Ratio (Raw, All Homes, Weekly) · Metro",
        "Sales · Median Sale Price (Raw, SFR only, Monthly) · Metro",
        "Sales · Median Sale Price (Smooth, SFR only, Weekly) · Metro",
        "Sales · Median Sale Price (Smooth, All Homes, Weekly) · Metro",
        "Sales · Median Sale Price (Nowcast, All Homes, Monthly) · Metro",
        "Sales · Median Sale-to-List Ratio (Raw, All Homes, Monthly) · Metro",
        "Sales · Median Sale-to-List Ratio (Smooth, All Homes, Monthly) · Metro",
        "Sales · Median Sale-to-List Ratio (Smooth, All Homes, Weekly) · Metro",
        "Sales · Median Sale-to-List Ratio (Raw, All Homes, Weekly) · Metro",
        "Sales · Percent of Homes Sold Above List (Raw, All Homes, Monthly) · Metro",
        "Sales · Percent of Homes Sold Above List (Smooth, All Homes, Monthly) · Metro",
        "Sales · Percent of Homes Sold Above List (Smooth, All Homes, Weekly) · Metro",
        "Sales · Percent of Homes Sold Above List (Raw, All Homes, Weekly) · Metro",
        "Sales · Percent of Homes Sold Below List (Raw, All Homes, Monthly) · Metro",
        "Sales · Percent of Homes Sold Below List (Smooth, All Homes, Monthly) · Metro",
        "Sales · Percent of Homes Sold Below List (Smooth, All Homes, Weekly) · Metro",
        "Sales · Percent of Homes Sold Below List (Raw, All Homes, Weekly) · Metro",
        "Sales · Sales Count (Nowcast, All Homes, Monthly) · Metro",
        "Sales · Sales Count (Raw, SFR only, Monthly) · Metro",
        "Sales · Sales Count (Smooth, SFR only, Weekly) · Metro",
        "Sales · Sales Count (Smooth, All Homes, Weekly) · Metro",
        "Sales · Total Transaction Value (Raw, SFR only, Monthly) · Metro",
        "Sales · Total Transaction Value (Smooth, SFR only, Weekly) · Metro",
        "Sales · Total Transaction Value (Smooth, All Homes, Weekly) · Metro",
        "Sales · Total Transaction Value (Nowcast, All Homes, Monthly) · Metro"
      ],
      "prefill": "market_temp_index_metro_uc_sfrcondo_month",
      "title": "Dataset",
      "type": "string"
    },
    "endDate": {
      "description": "Optional inclusive end date in YYYY-MM-DD format. Omit for the latest published date.",
      "editor": "textfield",
      "title": "End date",
      "type": "string"
    },
    "includeChanges": {
      "default": true,
      "description": "Add 1-month, 3-month and 1-year percentage changes to latest and snapshot records when prior values exist.",
      "prefill": false,
      "title": "Include changes",
      "type": "boolean"
    },
    "maxItems": {
      "default": 1000,
      "description": "Maximum number of records to return. Large ZIP or neighborhood histories need a date range, region filter, or a higher cap.",
      "maximum": 100000,
      "minimum": 1,
      "prefill": 3,
      "title": "Max items",
      "type": "integer"
    },
    "mode": {
      "default": "latest",
      "description": "What to return: latest values, full history, a multi-metric region snapshot, or the dataset catalog. The legacy options keep old saved tasks working with the previous wide output.",
      "editor": "select",
      "enum": [
        "latest",
        "history",
        "snapshot",
        "catalog",
        "search",
        "stateValues",
        "nationalTrends"
      ],
      "enumTitles": [
        "Latest values per region",
        "Full monthly/weekly history",
        "Multi-metric region snapshot",
        "List available datasets",
        "Legacy: search by state (wide output)",
        "Legacy: state values (wide output)",
        "Legacy: national market heat (wide output)"
      ],
      "prefill": "latest",
      "title": "Mode",
      "type": "string"
    },
    "regionIds": {
      "description": "Optional exact Zillow RegionIDs (for example 102001 for the United States). If both Regions and Region IDs are set, a row must match both.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Region IDs",
      "type": "array"
    },
    "regions": {
      "description": "Optional region names or substrings: 'Austin, TX', 'Texas', 'TX', '90210', 'Harris County'. Matches region, state, city, county and metro names. Leave empty for all regions.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Regions",
      "type": "array"
    },
    "snapshotMetrics": {
      "description": "Metrics to include in snapshot mode. Allowed values: zhvi, zori, inventory, newListings, medianListPrice, medianSalePrice, salesCount, daysToPending, priceCutShare, saleToListRatio, marketHeatIndex, newConstructionSales. Leave empty for all 12.",
      "editor": "stringList",
      "items": {
        "type": "string"
      },
      "title": "Snapshot metrics",
      "type": "array"
    },
    "startDate": {
      "description": "Optional inclusive start date in YYYY-MM-DD format. Omit for the earliest published date.",
      "editor": "textfield",
      "title": "Start date",
      "type": "string"
    }
  },
  "required": [
    "mode"
  ],
  "schemaVersion": 1,
  "title": "Zillow Research Data Input",
  "type": "object"
}

Output schema

Published result links and storage locations. This schema is not an exhaustive contract for every field in a dataset record.

Field	Type	Required	Description
`observations`	string	optional	Dataset containing tidy observation rows, metric snapshots, or dataset catalog records, depending on the selected mode.

Download the published output schema

View complete JSON

{
  "actorOutputSchemaVersion": 1,
  "description": "Zillow Research observations: home values, rents, inventory, days to pending, price cuts, sales, market heat, forecasts, new construction and affordability by US region and date.",
  "properties": {
    "observations": {
      "description": "Dataset containing tidy observation rows, metric snapshots, or dataset catalog records, depending on the selected mode.",
      "template": "{{links.apiDefaultDatasetUrl}}/items",
      "title": "Zillow Research observations",
      "type": "string"
    }
  },
  "title": "Zillow Research Data Scraper Output"
}

Dataset schema

Published dataset views and any declared field definitions. A view can select only a subset of the returned record fields.

Download the published dataset schema

View complete JSON

{
  "actorSpecification": 1,
  "views": {
    "latestSnapshot": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Latest snapshot",
      "transformation": {
        "fields": [
          "regionName",
          "state",
          "value",
          "date",
          "change1yPct",
          "unit",
          "metric"
        ]
      }
    },
    "observations": {
      "display": {
        "component": "table",
        "properties": {}
      },
      "title": "Observations",
      "transformation": {
        "fields": [
          "regionName",
          "regionType",
          "date",
          "value",
          "unit",
          "metric",
          "datasetId"
        ]
      }
    }
  }
}

Key-value schema

Published key-value store definitions, when provided by this build.

This definition is not present in the default published build. See the published README for available documentation.

Published README

Read the full published documentation

Zillow Research Data Scraper — ZHVI, ZORI & Market Heat

Download Zillow Research's public housing datasets as clean rows for analytics, dashboards and market reports. Choose from 208 home-value, rent, inventory, days-on-market, price-cut, sales, market-heat, forecast, new-construction and affordability files, for the US, states, metros, counties, cities, ZIP codes and neighborhoods Zillow publishes. No Zillow account, API key or proxy is needed.

What this actor does

208 datasets in one actor: every live file on Zillow's research data page, including all ZHVI cuts (all homes, SFR, condo, bedrooms, tiers), ZORI rent cuts, inventory, new listings, pending listings, median list price, sale prices, sales counts, days to pending/close, price cuts, sale-to-list, percent sold above/below list, market heat, ZHVF/ZORF forecasts, new construction and affordability.
Four modes: latest returns one row per region with the newest value and 1-month, 3-month and 1-year changes; history returns tidy rows for every region and date; snapshot returns a 12-metric view for selected metro regions with rent-to-price yield; catalog lists the available datasets.
Region and date filters: match names or Zillow RegionIDs, and select an inclusive date range.
Zillow join keys: records carry regionId, sizeRank, regionName and regionType so they join cleanly to other Zillow series.
Uses only published research files: it reads Zillow's CSV files, not the listings site, so it is not affected by listing anti-bot walls.
Empty values are omitted from records rather than returned as null.

Output per observation

One record per region in latest mode, or per region and date in history mode:

recordType — observation, metricSnapshot or dataset
datasetId, category, metric, metricName — the selected dataset and metric
geography, frequency — metro, state, county, city, zip, neighborhood or us; monthly or weekly
regionId, sizeRank, regionName, regionType — Zillow's region identity
stateName, state, city, countyName, metro — location fields, with state/county/metro filled in when Zillow leaves them blank
stateFips, municipalCodeFips — present in county-level files
date — observation date (YYYY-MM-DD)
value — numeric value in the dataset's unit
unit — USD, USD/month, USD/year, USD/sqft, percent, days, count, index, ratio or years
latestValue, latestDate — newest value in latest and snapshot modes
change1mPct, change3mPct, change1yPct — changes in latest and snapshot modes when prior values exist (4-week, 13-week and 52-week offsets on weekly datasets)
grossRentalYieldPct — annual rent divided by home value, when a snapshot has both ZORI and ZHVI
baseDate, horizonMonths — forecast origin and horizon (1, 3 or 12 months) on forecast rows
sourceUrl, dataSource, scrapedAt — the exact file read and the download time

In catalog mode, each record describes one dataset: datasetId, category, metric, metricName, geography, frequency, unit, dataType, firstDate, lastDate, sizeBytes, isForecast and sourceUrl.

Input

Field	Type	Default	Description
`mode`	string	`latest`	`latest`, `history`, `snapshot` or `catalog`; `search`, `stateValues` and `nationalTrends` are kept for old saved tasks and return the previous wide format
`dataset`	string	`market_temp_index_metro_uc_sfrcondo_month`	One of 208 Zillow Research datasets; the picker labels each by category, metric, geography and variant
`customDatasetUrl`	string	–	Advanced: a newer Zillow Research CSV URL, if Zillow adds a file before this actor's catalog is updated
`regions`	array	–	Region names or substrings, e.g. `["Austin, TX"]`, `["Texas"]`, `["90210"]`; empty for all
`regionIds`	array	–	Exact Zillow RegionIDs; if set with `regions`, a row must match both
`startDate`	string	–	Inclusive start date, `YYYY-MM-DD`
`endDate`	string	–	Inclusive end date, `YYYY-MM-DD`
`includeChanges`	boolean	`true`	Add 1-month, 3-month and 1-year changes in `latest`/`snapshot`
`snapshotMetrics`	array	all 12	Metrics to include in `snapshot` mode
`category`	string	`all`	Filter the catalog by category in `catalog` mode
`maxItems`	integer	`1000`	Record cap, 1–100,000

Example: latest home values and market heat for Austin

{
  "mode": "latest",
  "dataset": "zhvi_metro_uc_sfrcondo_tier_0_33_0_67_sm_sa_month",
  "regions": ["Austin, TX"],
  "includeChanges": true
}

Example: full rent history for one metro

{
  "mode": "history",
  "dataset": "zori_metro_uc_sfrcondomfr_sm_month",
  "regions": ["Austin, TX"],
  "startDate": "2015-01-01",
  "maxItems": 500
}

Example: 12-metric snapshot for a city

{
  "mode": "snapshot",
  "regions": ["Austin, TX"],
  "snapshotMetrics": ["zhvi", "zori", "inventory", "daysToPending", "marketHeatIndex"]
}

Example: browse the catalog

{
  "mode": "catalog",
  "category": "Market heat index"
}

Use cases

Housing analysts — track ZHVI, ZORI and inventory trends for metros, counties or ZIP codes.
Investors — compare typical home values and rents, including gross rental yield, across markets.
PropTech and data teams — load tidy region/date/value rows into a warehouse for dashboards and models.
Market researchers — monitor market heat, days to pending, price cuts and sale-to-list ratios.
Economic and policy teams — pull affordability, new-construction and forecast series for reports.
Data journalists — export a single ZIP or metro's full history for a story.

FAQ

Is this affiliated with Zillow? No. This actor reads Zillow Research's public data files. Zillow is not affiliated with and does not endorse this actor. Attribution to Zillow Research is required when you publish the data.

Do I need a Zillow account, API key or proxy? No. The research CSV files are public. The actor needs no login, API key, cookie or proxy configuration.

What is the difference between ZHVI and ZORI? ZHVI is Zillow's typical home value index. ZORI is its observed rent index. The dataset picker includes all-homes, single-family, condo, bedroom-count and price-tier cuts where Zillow publishes them.

Why does rent data cover fewer metros than home values? Zillow publishes ZORI for fewer regions than ZHVI. The actor returns only regions present in the chosen file; it does not fill missing regions with estimates.

Why do some months have no value for my region? Zillow starts some series later or stops publishing a cut. Empty cells are skipped, so a record appears only when Zillow published a value for that region and month.

Why does history data sometimes change between runs? Zillow restates its back-series when methodology or source data change. Each run reads the current published file, so a later download can differ from an earlier one. scrapedAt records when the file was read.

How do I get a full ZIP or neighborhood history? Those files are large and the actor caps output at 100,000 records per run. Use latest for a current snapshot, or split the request by state, region or date range.

Are market heat and forecast values percentages? Market heat is an index value; higher means a hotter seller's market. ZHVF and ZORF forecast values are percentages. The unit field on every row tells you which applies.

Can I use a dataset that is not in the picker? Yes. Paste its Zillow Research CSV URL into customDatasetUrl. Only files.zillowstatic.com/research/...csv URLs are accepted.

How current is the data? Zillow updates monthly datasets around the middle of the following month and weekly files on a monthly cadence. The latestDate field shows the newest observation in the file you selected.

Python quickstart

Use a schema-derived input and the Python standard library to start a run. An Apify account and token are required for execution.

Open the step-by-step Python guide →

Source build LmI1eGACKbWePrgNH. Documentation is regenerated from the default published build; private drafts are not included.