# Zillow Housing Market Scraper (`powerai/zillow-housing-market-scraper`)

Scrape housing market data from Zillow, including home values, market trends, and neighborhood statistics.

- **URL**: https://beta-securitybyobscurity.apify.com/powerai/zillow-housing-market-scraper.md
- **Developed by:** [PowerAI](https://beta-securitybyobscurity.apify.com/powerai) (community)
- **Categories:** Real estate, Other
- **Stats:** 7 total users, 3 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: 5.00 out of 5 stars

## Pricing

Pay per event

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

# README

## Zillow Housing Market Scraper

This actor scrapes housing market data from Zillow for a specific location.

### Features

- Search housing market data by location
- Returns comprehensive market information including:
  - Typical home values
  - Market overview
  - Sale-to-list ratios
  - Inventory levels
  - Price trends
  - Market analytics

### Input Parameters

- `search_query` (string, required): Location or area to search for housing market data
- `home_type` (string, optional): Type of homes to include (default: "All\_Homes")
- `exclude_rentalMarketTrends` (boolean, optional): Exclude rental market trends (default: false)
- `exclude_neighborhoods_zhvi` (boolean, optional): Exclude neighborhood ZHVI data (default: false)

### Output Data

The output includes the following fields:

- `market_overview`:
  - `typical_home_values`: Typical home values in the area
  - `description`: Market description
  - `for_sale_inventory`: Number of homes for sale
  - `new_listings`: Number of new listings
  - `market_saletolist_ratio`: Sale-to-list ratio
  - `median_sale_price`: Median sale price
  - `median_list_price`: Median list price
  - `percent_ofsales_over_list_price`: Percentage of sales over list price
  - `percent_ofsales_under_list_price`: Percentage of sales under list price
  - `median_days_to_pending`: Median days to pending
- `market_analytics`: Detailed market analytics data
- `search_url`: URL for the search results
- `scrapedAt`: Data scraping timestamp

### Example Usage

```json
{
    "search_query": "New York, NY",
    "home_type": "All_Homes",
    "exclude_rentalMarketTrends": false,
    "exclude_neighborhoods_zhvi": false
}
```

### Output Example

```json
[
  {
    "message": "success",
    "source": "9vrc",
    "search_query": "New York, NY",
    "market_overview": {
      "typical_home_values": 795967,
      "description": "The average home value in New York, NY is $795,968, up 3.5% over the past year. Learn more about the New York housing market and real estate trends.",
      "for_sale_inventory": 14496,
      "new_listings": 3436,
      "market_saletolist_ratio": 0.977,
      "median_sale_price": 726666,
      "median_list_price": 872666,
      "percent_ofsales_over_list_price": 19.5,
      "percent_ofsales_under_list_price": 68.8,
      "median_days_to_pending": 58,
      "whats_zhvi": "The Zillow Home Value Index or ZHVI is a smoothed, seasonally adjusted measure of the typical home value and market changes across a given region and housing type. It reflects the typical value for homes in the 35th to 65th percentile range."
    },
    "market_analytics": {
      "zhviRange": [
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2025-04-30",
          "dataValue": 795967.9892844051
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2025-03-31",
          "dataValue": 793230.3215565722
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2025-02-28",
          "dataValue": 791970.764978659
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2025-01-31",
          "dataValue": 790783.0855628789
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-12-31",
          "dataValue": 789328.1424348061
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-11-30",
          "dataValue": 786459.3882500207
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-10-31",
          "dataValue": 783563.5357425427
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-09-30",
          "dataValue": 780666.7319796025
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-08-31",
          "dataValue": 777154.6142336655
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-07-31",
          "dataValue": 774294.2385336816
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-06-30",
          "dataValue": 773094.2768487219
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-05-31",
          "dataValue": 772315.3985104179
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-04-30",
          "dataValue": 769001.0946546475
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-03-31",
          "dataValue": 764231.6513308194
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-02-29",
          "dataValue": 759876.8710066411
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2024-01-31",
          "dataValue": 757757.5898624207
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-12-31",
          "dataValue": 757256.9916191756
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-11-30",
          "dataValue": 758572.7550856328
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-10-31",
          "dataValue": 761495.7035799049
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-09-30",
          "dataValue": 764664.8542457403
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-08-31",
          "dataValue": 767255.4432195112
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-07-31",
          "dataValue": 769210.9356130509
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-06-30",
          "dataValue": 770129.1125525226
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-05-31",
          "dataValue": 769841.283743468
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-04-30",
          "dataValue": 770039.2963038877
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-03-31",
          "dataValue": 772676.8898973687
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-02-28",
          "dataValue": 779183.3440721632
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2023-01-31",
          "dataValue": 787850.4068136103
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-12-31",
          "dataValue": 795613.0898330901
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-11-30",
          "dataValue": 801449.866131301
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-10-31",
          "dataValue": 806908.957960221
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-09-30",
          "dataValue": 812717.1199662831
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-08-31",
          "dataValue": 819743.1152859097
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-07-31",
          "dataValue": 821069.2244175189
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-06-30",
          "dataValue": 818242.9723498459
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-05-31",
          "dataValue": 811988.0166437592
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-04-30",
          "dataValue": 804697.0442161827
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-03-31",
          "dataValue": 796656.0892596665
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-02-28",
          "dataValue": 788003.3977281864
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2022-01-31",
          "dataValue": 783062.4026015227
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-12-31",
          "dataValue": 778776.4808617275
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-11-30",
          "dataValue": 773864.2095253632
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-10-31",
          "dataValue": 768455.0607860986
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-09-30",
          "dataValue": 765019.836413369
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-08-31",
          "dataValue": 763651.0010499904
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-07-31",
          "dataValue": 762381.7147958102
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-06-30",
          "dataValue": 759326.8764069859
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-05-31",
          "dataValue": 756907.1340352794
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-04-30",
          "dataValue": 753321.8745174496
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-03-31",
          "dataValue": 750261.8322232437
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-02-28",
          "dataValue": 746629.0430296535
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2021-01-31",
          "dataValue": 743352.0673326319
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-12-31",
          "dataValue": 740959.3258724379
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-11-30",
          "dataValue": 738048.2988427883
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-10-31",
          "dataValue": 734954.535173912
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-09-30",
          "dataValue": 732799.783527032
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-08-31",
          "dataValue": 731610.2311201418
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-07-31",
          "dataValue": 733322.9762555804
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-06-30",
          "dataValue": 734380.4862382686
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-05-31",
          "dataValue": 734808.8390197189
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-04-30",
          "dataValue": 734054.3388309655
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-03-31",
          "dataValue": 734567.0421870084
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-02-29",
          "dataValue": 735011.9800827658
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2020-01-31",
          "dataValue": 735308.4382761144
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-12-31",
          "dataValue": 732533.318686047
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-11-30",
          "dataValue": 730199.4006034047
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-10-31",
          "dataValue": 728800.3431527499
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-09-30",
          "dataValue": 730412.7944562241
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-08-31",
          "dataValue": 731256.6443973804
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-07-31",
          "dataValue": 730252.9867534888
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-06-30",
          "dataValue": 727992.8334013355
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-05-31",
          "dataValue": 725564.723601296
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-04-30",
          "dataValue": 723890.6598143665
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-03-31",
          "dataValue": 721344.4733111939
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-02-28",
          "dataValue": 718954.0612272952
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2019-01-31",
          "dataValue": 716721.5505951337
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-12-31",
          "dataValue": 716263.0972831411
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-11-30",
          "dataValue": 716605.2249730936
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-10-31",
          "dataValue": 714998.9847932281
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-09-30",
          "dataValue": 712090.6395395655
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-08-31",
          "dataValue": 707405.0125449301
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-07-31",
          "dataValue": 703668.2950060855
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-06-30",
          "dataValue": 699484.9513885854
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-05-31",
          "dataValue": 695365.4078106497
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-04-30",
          "dataValue": 690027.4673149537
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-03-31",
          "dataValue": 685467.7914723951
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-02-28",
          "dataValue": 680234.4744591443
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2018-01-31",
          "dataValue": 675034.5326972365
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-12-31",
          "dataValue": 670128.6370364975
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-11-30",
          "dataValue": 665961.4166506177
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-10-31",
          "dataValue": 663536.2448373326
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-09-30",
          "dataValue": 659772.0991271571
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-08-31",
          "dataValue": 656745.7180276056
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-07-31",
          "dataValue": 652661.4236014929
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-06-30",
          "dataValue": 649883.9788165763
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-05-31",
          "dataValue": 646098.7631989664
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-04-30",
          "dataValue": 642057.204488866
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-03-31",
          "dataValue": 636125.5835118851
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-02-28",
          "dataValue": 631444.4696045216
        },
        {
          "__typename": "Zhvi",
          "timePeriodEnd": "2017-01-31",
          "dataValue": 625609.2119711799
        }
      ],
      "nationalZori": [
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2025-04-30",
          "zori": 2023.7238908193956
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2025-03-31",
          "zori": 2013.6698608128904
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2025-02-28",
          "zori": 2001.0033442632998
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2025-01-31",
          "zori": 1992.752732413821
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-12-31",
          "zori": 1988.3130648838182
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-11-30",
          "zori": 1991.8471262797968
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-10-31",
          "zori": 1994.9484958258736
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-09-30",
          "zori": 1998.4709319732208
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-08-31",
          "zori": 1996.7582340517538
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-07-31",
          "zori": 1991.4326671616413
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-06-30",
          "zori": 1981.4263584276107
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-05-31",
          "zori": 1969.7071830112882
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-04-30",
          "zori": 1957.1481169606334
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-03-31",
          "zori": 1945.3046056656683
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-02-29",
          "zori": 1933.6583055060894
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-01-31",
          "zori": 1925.4055130754448
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-12-31",
          "zori": 1922.3780902634796
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-11-30",
          "zori": 1925.7561292363143
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-10-31",
          "zori": 1931.1456356767662
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-09-30",
          "zori": 1934.426114341961
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-08-31",
          "zori": 1932.9969395882572
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-07-31",
          "zori": 1927.51191267199
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-06-30",
          "zori": 1917.7880945098632
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-05-31",
          "zori": 1909.5410881045934
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-04-30",
          "zori": 1896.8453688801221
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-03-31",
          "zori": 1885.6283167201182
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-02-28",
          "zori": 1872.9705646350053
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-01-31",
          "zori": 1866.1318093412772
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-12-31",
          "zori": 1864.091122146928
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-11-30",
          "zori": 1867.171209275262
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-10-31",
          "zori": 1873.3540106269186
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-09-30",
          "zori": 1877.9792546471326
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-08-31",
          "zori": 1875.3823963554357
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-07-31",
          "zori": 1864.554027847052
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-06-30",
          "zori": 1845.7140423890432
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-05-31",
          "zori": 1823.2380388597478
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-04-30",
          "zori": 1801.899864862063
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-03-31",
          "zori": 1780.8998201245547
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-02-28",
          "zori": 1764.719262886359
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-01-31",
          "zori": 1749.0450457319014
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-12-31",
          "zori": 1738.0020342603232
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-11-30",
          "zori": 1728.3235549400974
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-10-31",
          "zori": 1718.4677044233747
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-09-30",
          "zori": 1703.3679410801333
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-08-31",
          "zori": 1679.2316116439126
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-07-31",
          "zori": 1649.4102030929698
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-06-30",
          "zori": 1617.2415784313102
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-05-31",
          "zori": 1586.675027139675
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-04-30",
          "zori": 1560.5599933039487
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-03-31",
          "zori": 1540.7890455260185
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-02-28",
          "zori": 1525.1311012524764
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-01-31",
          "zori": 1513.1599620598163
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-12-31",
          "zori": 1505.7191857247046
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-11-30",
          "zori": 1503.4693145429699
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-10-31",
          "zori": 1504.8247468533752
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-09-30",
          "zori": 1507.7669535549153
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-08-31",
          "zori": 1510.3495530394505
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-07-31",
          "zori": 1508.9726976577035
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-06-30",
          "zori": 1503.6908375507192
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-05-31",
          "zori": 1503.2642237367047
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-04-30",
          "zori": 1504.094667440759
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-03-31",
          "zori": 1503.1977834279255
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-02-29",
          "zori": 1494.6757182402264
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-01-31",
          "zori": 1486.3126737124712
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-12-31",
          "zori": 1481.1782273264664
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-11-30",
          "zori": 1479.981308783866
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-10-31",
          "zori": 1481.0820169753197
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-09-30",
          "zori": 1482.439688175495
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-08-31",
          "zori": 1482.6172125098735
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-07-31",
          "zori": 1479.5193362665784
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-06-30",
          "zori": 1473.5906028014444
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-05-31",
          "zori": 1465.4584621510057
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-04-30",
          "zori": 1455.318698466546
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-03-31",
          "zori": 1444.9949671878176
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-02-28",
          "zori": 1434.4931561286082
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-01-31",
          "zori": 1428.255518492721
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-12-31",
          "zori": 1423.911384638587
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-11-30",
          "zori": 1421.812766998902
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-10-31",
          "zori": 1421.2584730293484
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-09-30",
          "zori": 1422.0135027653987
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-08-31",
          "zori": 1422.5768213268282
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-07-31",
          "zori": 1419.2626195039002
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-06-30",
          "zori": 1413.780664728881
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-05-31",
          "zori": 1406.1062020712966
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-04-30",
          "zori": 1397.6845968245946
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-03-31",
          "zori": 1387.8666834696016
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-02-28",
          "zori": 1378.1350741658698
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-01-31",
          "zori": 1370.5698700022604
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-12-31",
          "zori": 1365.6339997778248
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-11-30",
          "zori": 1364.6252108481985
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-10-31",
          "zori": 1364.7869489068814
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-09-30",
          "zori": 1366.3701573127194
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-08-31",
          "zori": 1366.1206969606278
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-07-31",
          "zori": 1364.4474853864028
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-06-30",
          "zori": 1359.4439693996026
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-05-31",
          "zori": 1352.2164670906452
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-04-30",
          "zori": 1342.7407093145887
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-03-31",
          "zori": 1332.787465862101
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-02-28",
          "zori": 1320.9303613249563
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-01-31",
          "zori": 1313.094096000313
        }
      ],
      "rentalMrktRange": [
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2025-04-30",
          "zori": 3710.2643276564013
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2025-03-31",
          "zori": 3664.2291381023574
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2025-02-28",
          "zori": 3620.420039275231
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2025-01-31",
          "zori": 3589.20247895838
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-12-31",
          "zori": 3583.4790788613955
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-11-30",
          "zori": 3598.781640148202
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-10-31",
          "zori": 3623.81586520434
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-09-30",
          "zori": 3647.113432761694
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-08-31",
          "zori": 3663.135415058754
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-07-31",
          "zori": 3660.226734526611
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-06-30",
          "zori": 3638.86446695121
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-05-31",
          "zori": 3602.0407460095607
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-04-30",
          "zori": 3557.456358882363
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-03-31",
          "zori": 3516.08487524263
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-02-29",
          "zori": 3477.4838437455332
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2024-01-31",
          "zori": 3453.2140269171264
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-12-31",
          "zori": 3457.4205153590374
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-11-30",
          "zori": 3486.194733741718
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-10-31",
          "zori": 3524.9473356217586
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-09-30",
          "zori": 3548.9688161560407
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-08-31",
          "zori": 3553.4944308028134
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-07-31",
          "zori": 3540.6748769678175
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-06-30",
          "zori": 3509.468270115193
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-05-31",
          "zori": 3466.5553644020833
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-04-30",
          "zori": 3424.1557014115874
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-03-31",
          "zori": 3390.330883765693
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-02-28",
          "zori": 3365.598257292932
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2023-01-31",
          "zori": 3353.4627825819284
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-12-31",
          "zori": 3359.882183780778
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-11-30",
          "zori": 3389.9221006195125
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-10-31",
          "zori": 3428.3592448407117
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-09-30",
          "zori": 3448.2372623139454
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-08-31",
          "zori": 3443.4688168776324
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-07-31",
          "zori": 3411.459690003262
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-06-30",
          "zori": 3356.7377624263477
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-05-31",
          "zori": 3294.260643306801
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-04-30",
          "zori": 3233.7188413714184
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-03-31",
          "zori": 3184.959270123124
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-02-28",
          "zori": 3138.934093544762
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2022-01-31",
          "zori": 3102.652427977204
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-12-31",
          "zori": 3073.1462946463744
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-11-30",
          "zori": 3053.0520148269698
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-10-31",
          "zori": 3025.281288921133
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-09-30",
          "zori": 2989.1758027274095
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-08-31",
          "zori": 2927.8346613990943
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-07-31",
          "zori": 2852.046692988311
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-06-30",
          "zori": 2767.916588991768
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-05-31",
          "zori": 2694.7811160084784
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-04-30",
          "zori": 2636.445694149221
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-03-31",
          "zori": 2594.2323926255367
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-02-28",
          "zori": 2565.33314571541
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2021-01-31",
          "zori": 2549.9016891359174
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-12-31",
          "zori": 2559.802717806071
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-11-30",
          "zori": 2584.9602898679072
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-10-31",
          "zori": 2632.756881601319
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-09-30",
          "zori": null
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-08-31",
          "zori": null
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-07-31",
          "zori": 2838.5422960673845
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-06-30",
          "zori": 2879.530769796385
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-05-31",
          "zori": 2920.7031135142643
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-04-30",
          "zori": 2950.28811500211
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-03-31",
          "zori": 2960.637830685203
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-02-29",
          "zori": 2946.0760119071656
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2020-01-31",
          "zori": 2927.6117532202984
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-12-31",
          "zori": 2930.8146704676406
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-11-30",
          "zori": 2944.138018408952
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-10-31",
          "zori": 2961.6576276259616
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-09-30",
          "zori": 2967.390995159925
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-08-31",
          "zori": 2964.8162476166167
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-07-31",
          "zori": 2952.3083809417662
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-06-30",
          "zori": 2931.3374655579178
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-05-31",
          "zori": 2904.4054575025298
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-04-30",
          "zori": 2877.666221801347
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-03-31",
          "zori": 2853.8274591317995
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-02-28",
          "zori": 2835.592471310768
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2019-01-31",
          "zori": 2826.2001320434606
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-12-31",
          "zori": 2829.706339074403
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-11-30",
          "zori": 2845.757789093963
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-10-31",
          "zori": 2862.9319132391665
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-09-30",
          "zori": 2875.585556918499
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-08-31",
          "zori": 2874.21012092808
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-07-31",
          "zori": 2863.743615681355
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-06-30",
          "zori": 2848.010176190672
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-05-31",
          "zori": 2826.0470127060985
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-04-30",
          "zori": 2801.7712661670375
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-03-31",
          "zori": 2778.4410709828444
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-02-28",
          "zori": 2760.7702684921246
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2018-01-31",
          "zori": 2753.0990179360438
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-12-31",
          "zori": 2755.7313148140274
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-11-30",
          "zori": 2774.221761483799
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-10-31",
          "zori": 2799.355051988728
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-09-30",
          "zori": 2820.3843610412205
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-08-31",
          "zori": 2828.9666812132496
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-07-31",
          "zori": 2824.896004752859
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-06-30",
          "zori": 2811.339491658784
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-05-31",
          "zori": 2791.1932251318767
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-04-30",
          "zori": 2769.6179274499946
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-03-31",
          "zori": 2752.5383227235125
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-02-28",
          "zori": 2739.21025070908
        },
        {
          "__typename": "RentalMrkt",
          "timePeriodEnd": "2017-01-31",
          "zori": 2739.9585459751956
        }
      ],
      "neighborHoodRegionsResponse": {
        "neighborhoodWithZhviList": [
          {
            "regionId": 270969,
            "regionName": "Wingate",
            "zhvi": 814105.0366866571,
            "regionUrl": "/wingate-brooklyn-new-york-ny/"
          },
          {
            "regionId": 403222,
            "regionName": "Crown Heights",
            "zhvi": 1067691.5559973589,
            "regionUrl": "/crown-heights-brooklyn-new-york-ny/"
          },
          {
            "regionId": 403221,
            "regionName": "Prospect Lefferts Gardens",
            "zhvi": 1342943.9206993713,
            "regionUrl": "/prospect-lefferts-gardens-brooklyn-new-york-ny/"
          },
          {
            "regionId": 193526,
            "regionName": "Brownsville",
            "zhvi": 659188.4202294386,
            "regionUrl": "/brownsville-brooklyn-new-york-ny/"
          },
          {
            "regionId": 194379,
            "regionName": "East Flatbush",
            "zhvi": 716083.1442007303,
            "regionUrl": "/east-flatbush-brooklyn-new-york-ny/"
          },
          {
            "regionId": 194737,
            "regionName": "Flatbush",
            "zhvi": 711961.2526692492,
            "regionUrl": "/flatbush-brooklyn-new-york-ny/"
          },
          {
            "regionId": 272902,
            "regionName": "Bedford-Stuyvesant",
            "zhvi": 1099139.5810513254,
            "regionUrl": "/bedford-stuyvesant-brooklyn-new-york-ny/"
          },
          {
            "regionId": 403161,
            "regionName": "Prospect Park",
            "zhvi": null,
            "regionUrl": "/prospect-park-brooklyn-new-york-ny/"
          },
          {
            "regionId": 270914,
            "regionName": "Prospect Park South",
            "zhvi": 939778.5283521957,
            "regionUrl": "/prospect-park-south-brooklyn-new-york-ny/"
          }
        ],
        "currentRegionType": "CITY"
      },
      "mrktSaleRange": [
        {
          "__typename": "MrktSale",
          "timePeriodEnd": "2025-03-31",
          "medianSaleToList": 0.9770270102578335,
          "pctSoldAboveList": 0.19539770667990142,
          "pctSoldBelowList": 0.6875605749147616
        },
        {
          "__typename": "MrktSale",
          "timePeriodEnd": "2025-02-28",
          "medianSaleToList": 0.9778679923116304,
          "pctSoldAboveList": 0.19651060078458352,
          "pctSoldBelowList": 0.683618118347035
        },
        {
          "__typename": "MrktSale",
          "timePeriodEnd": "2025-01-31",
          "medianSaleToList": 0.9779646779229864,
          "pctSoldAboveList": 0.19931497834956302,
          "pctSoldBelowList": 0.6779620747064953
        }
      ],
      "mrktListingRange": [
        {
          "__typename": "MrktListing",
          "medianDaysToPending": 58.666666666666664,
          "timePeriodEnd": "2025-04-30"
        },
        {
          "__typename": "MrktListing",
          "medianDaysToPending": 73.33333333333333,
          "timePeriodEnd": "2025-03-31"
        },
        {
          "__typename": "MrktListing",
          "medianDaysToPending": 82.66666666666667,
          "timePeriodEnd": "2025-02-28"
        }
      ],
      "mrktListingLatest": {
        "__typename": "MrktListing",
        "newListings": 3436.6666666666665,
        "forSaleInventory": 14496.333333333334,
        "medianListPrice": 872666.6666666666,
        "timePeriodEnd": "2025-04-30"
      }
    },
    "search_url": "https://www.zillow.com/home-values/6181/new-york-ny/",
    "scrapedAt": "2025-06-04T06:04:38.732Z"
  }
]
```

### Notes

1. Ensure valid search query is provided
2. API may have rate limits
3. Returned data may vary based on location and market conditions

# Actor input Schema

## `search_query` (type: `string`):

Location or area to search for housing market data

## `home_type` (type: `string`):

Type of homes to include in the market data

## `exclude_rentalMarketTrends` (type: `boolean`):

Exclude rental market trends from the results

## `exclude_neighborhoods_zhvi` (type: `boolean`):

Exclude neighborhood Zillow Home Value Index data

## Actor input object example

```json
{
  "search_query": "New York, NY",
  "home_type": "All_Homes",
  "exclude_rentalMarketTrends": false,
  "exclude_neighborhoods_zhvi": false
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("powerai/zillow-housing-market-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("powerai/zillow-housing-market-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call powerai/zillow-housing-market-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=powerai/zillow-housing-market-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Zillow Housing Market Scraper",
        "description": "Scrape housing market data from Zillow, including home values, market trends, and neighborhood statistics.",
        "version": "0.0",
        "x-build-id": "GKPzw6NiHc8Fhxs25"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/powerai~zillow-housing-market-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-powerai-zillow-housing-market-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/powerai~zillow-housing-market-scraper/runs": {
            "post": {
                "operationId": "runs-sync-powerai-zillow-housing-market-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/powerai~zillow-housing-market-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-powerai-zillow-housing-market-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "required": [
                    "search_query"
                ],
                "properties": {
                    "search_query": {
                        "title": "Search Query",
                        "type": "string",
                        "description": "Location or area to search for housing market data",
                        "default": "New York, NY"
                    },
                    "home_type": {
                        "title": "Home Type",
                        "enum": [
                            "All_Homes"
                        ],
                        "type": "string",
                        "description": "Type of homes to include in the market data",
                        "default": "All_Homes"
                    },
                    "exclude_rentalMarketTrends": {
                        "title": "Exclude Rental Market Trends",
                        "type": "boolean",
                        "description": "Exclude rental market trends from the results",
                        "default": false
                    },
                    "exclude_neighborhoods_zhvi": {
                        "title": "Exclude Neighborhoods ZHVI",
                        "type": "boolean",
                        "description": "Exclude neighborhood Zillow Home Value Index data",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
