# Zillow Search by Polygon Scraper (`axesso_data/zillow-search-by-polygon-scraper`) Actor

The Zillow Search by Polygon Scraper retrieves real-time property listings within a custom map area defined by polygon coordinates. Filter by price, beds, baths, home type, and status to collect structured listing data for real estate research and lead generation.

- **URL**: https://apify.com/axesso\_data/zillow-search-by-polygon-scraper.md
- **Developed by:** [AxCrawler](https://apify.com/axesso_data) (community)
- **Categories:** Real estate
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.10 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### How does Zillow Search by Polygon Scraper work?

The Zillow Search by Polygon Scraper retrieves real-time property listings located within a custom map area, defined by a set of polygon coordinates. The data extracted for each property includes attributes such as address, price, number of bedrooms and bathrooms, living area, home type, listing status, and Zestimate, among other real estate details.

This Actor performs live queries directly to Zillow, ensuring that all data returned is current and accurate at the time of the request. There is no caching involved, so every invocation retrieves fresh data.

The extraction process involves receiving a polygon, together with optional filters such as price, beds, baths, status, and sorting, for one or more search requests, executing the data retrieval for each polygon, and returning structured JSON output containing the matching property listings.

### Input data

Input data must be provided in JSON format and must contain one mandatory array field "input". Each item in the array represents one polygon search request and is sent 1:1 as the JSON request body of the search. Every field listed below is supported:

#### Core parameters

| Parameter | Required | Type | Description |
|---|---|---|---|
| `polygon` | Yes\* | array | Polygon defining the map area to search, given as an array of `[lat, long]` pairs, e.g. `[[28.9520687, -81.9596345], [28.9544720, -81.9939668], ...]`. Repeat the first point as the last point to close the shape. \*Required unless `customRegionId` is provided. |
| `customRegionId` | No | string | Identifier of a previously resolved custom map region. Returned as `customRegionId` in every response and can be sent instead of `polygon` to repeat the exact same search area. |
| `page` | No | number | Page number of the results to retrieve. Defaults to `1`. The total number of pages is returned as `totalPages`. |
| `status` | No | string | Status type of the properties to search for. Possible values: `forSale` (default), `forRent`, `recentlySold`. |
| `listing_type` | No | string | Listing type. Possible values: `by_agent` (default, by agent), `by_owner_other` (by owner & other, for off market properties). |
| `sortSelection` | No | string | Sorting order of the results. Possible values: `days` (default, newest), `saved`, `listingstatus`, `mostrecentchange`, `globalrelevanceex`, `featured`, `priced`, `pricea`, `paymentd`, `paymenta`, `beds`, `baths`, `size`, `lot`, `zest`, `zesta`. |
| `doz` | No | number | Days on Zillow (For Sale/Rent listings) or Sold In Last (Sold listings) filter, in days, e.g. `1`, `7`, `14`, `30`, `90`. |
| `keywords` | No | string | Free-text keyword filter applied to the search. |

#### Price, size and payment filters

| Parameter | Required | Type | Description |
|---|---|---|---|
| `price_min` | No | number | Minimum price filter for the search results. |
| `price_max` | No | number | Maximum price filter for the search results. |
| `beds_min` | No | number | Minimum number of bedrooms filter. |
| `beds_max` | No | number | Maximum number of bedrooms filter. |
| `baths_min` | No | number | Minimum number of bathrooms filter. |
| `baths_max` | No | number | Maximum number of bathrooms filter. |
| `sqft_min` | No | number | Minimum living area (square feet) filter. |
| `sqft_max` | No | number | Maximum living area (square feet) filter. |
| `lotSize_min` | No | number | Minimum lot size filter, in sqft. |
| `lotSize_max` | No | number | Maximum lot size filter, in sqft. |
| `built_min` | No | number | Minimum year built filter. |
| `built_max` | No | number | Maximum year built filter. |
| `hoa_min` | No | number | Minimum HOA fee filter. |
| `hoa_max` | No | number | Maximum HOA fee filter. |
| `monthlyPayment_min` | No | number | Minimum estimated monthly payment filter. |
| `monthlyPayment_max` | No | number | Maximum estimated monthly payment filter. |
| `parkingSpots_min` | No | number | Minimum number of parking spots filter. |

#### Home types

| Parameter | Required | Type | Description |
|---|---|---|---|
| `isSingleFamily` | No | boolean | Filter for single-family homes. |
| `isCondo` | No | boolean | Filter for condominiums. |
| `isTownhouse` | No | boolean | Filter for townhouses. |
| `isApartment` | No | boolean | Filter for apartments. |
| `isMultiFamily` | No | boolean | Filter for multi-family properties. |
| `isManufactured` | No | boolean | Filter for manufactured homes. |
| `isLotLand` | No | boolean | Filter for lot/land properties. |

#### Listing type and status filters

| Parameter | Required | Type | Description |
|---|---|---|---|
| `isForSaleByAgent` | No | boolean | Filter for properties for sale by agent. |
| `isForSaleByOwner` | No | boolean | Filter for properties for sale by owner. |
| `isNewConstruction` | No | boolean | Filter for new construction properties. |
| `isComingSoon` | No | boolean | Filter for coming-soon listings. |
| `isAuction` | No | boolean | Filter for properties listed as auctions. |
| `isForSaleForeclosure` | No | boolean | Filter for foreclosure listings. |
| `isZillowOwnedOnly` | No | boolean | Filter to only include Zillow-owned properties. |
| `onlyPriceReduction` | No | boolean | Filter to only include listings with a recent price reduction. |

#### Property features

| Parameter | Required | Type | Description |
|---|---|---|---|
| `hasPool` | No | boolean | Filter for properties with a pool. |
| `hasGarage` | No | boolean | Filter for properties with a garage. |
| `hasAirConditioning` | No | boolean | Filter for properties with air conditioning. |
| `singleStory` | No | boolean | Filter for single-story properties. |
| `is3dHome` | No | boolean | Filter for listings with a 3D home tour. |
| `onlyWithPhotos` | No | boolean | Filter to only include listings that have photos. |

#### Views and waterfront

| Parameter | Required | Type | Description |
|---|---|---|---|
| `isCityView` | No | boolean | Filter for properties with a city view. |
| `isParkView` | No | boolean | Filter for properties with a park view. |
| `isMountainView` | No | boolean | Filter for properties with a mountain view. |
| `isWaterView` | No | boolean | Filter for properties with a water view. |
| `isWaterfront` | No | boolean | Filter for waterfront properties. |

#### Schools

| Parameter | Required | Type | Description |
|---|---|---|---|
| `enableSchools` | No | boolean | Whether to include nearby school information in the results. |
| `isPublicSchool` | No | boolean | Filter results by proximity to public schools. |
| `isPrivateSchool` | No | boolean | Filter results by proximity to private schools. |
| `isElementarySchool` | No | boolean | Filter results by proximity to elementary schools. |
| `isMiddleSchool` | No | boolean | Filter results by proximity to middle schools. |
| `greatSchoolsRating_min` | No | number | Minimum GreatSchools rating filter for nearby schools. |

#### Rental options

| Parameter | Required | Type | Description |
|---|---|---|---|
| `onlyRentalPetsAllowed` | No | boolean | Filter for rentals that allow pets. |
| `onlyRentalCatsAllowed` | No | boolean | Filter for rentals that allow cats. |
| `onlyRentalSmallDogsAllowed` | No | boolean | Filter for rentals that allow small dogs. |
| `onlyRentalLargeDogsAllowed` | No | boolean | Filter for rentals that allow large dogs. |
| `onlyRentalIncomeRestricted` | No | boolean | Filter for income-restricted rentals. |
| `onlyRentalAcceptsApplications` | No | boolean | Filter for rentals currently accepting applications. |

#### Polygon format

The polygon is an array of coordinate pairs, each pair being `[latitude, longitude]`:

```json
"polygon": [
  [28.9520687326739, -81.9596345263672],
  [28.9544720326552, -81.9939668017578],
  [28.9532703896359, -82.0282990771485],
  [28.9520687326739, -81.9596345263672]
]
```

The first coordinate pair must be repeated as the last pair to close the shape. At least three distinct points are needed to describe an area. Very narrow polygons or areas without listings return an empty result set.

Multiple polygon searches can be processed in a single run by providing multiple entries in the "input" array. Combining many filters at once narrows the search considerably and may return no results.

#### Example input

```json
{
  "input": [
    {
      "polygon": [
        [28.9520687326739, -81.9596345263672],
        [28.9544720326552, -81.9939668017578],
        [28.9532703896359, -82.0282990771485],
        [28.9244267751812, -82.0406586962891],
        [28.8943728089739, -82.0502717333985],
        [28.8643101397807, -82.0571381884766],
        [28.8426596323051, -82.0324189501953],
        [28.8390507762033, -81.9967133837891],
        [28.8366448025959, -81.9623811083985],
        [28.8462683632266, -81.9294221240235],
        [28.8787413067622, -81.9266755419922],
        [28.9112041026263, -81.9266755419922],
        [28.942454975081, -81.9266755419922],
        [28.956875276864, -81.956887944336],
        [28.9520687326739, -81.9596345263672]
      ],
      "page": 1,
      "status": "forSale",
      "sortSelection": "priced"
    },
    {
      "polygon": [
        [28.9520687326739, -81.9596345263672],
        [28.9544720326552, -81.9939668017578],
        [28.9532703896359, -82.0282990771485],
        [28.9244267751812, -82.0406586962891],
        [28.8943728089739, -82.0502717333985],
        [28.8643101397807, -82.0571381884766],
        [28.8426596323051, -82.0324189501953],
        [28.8390507762033, -81.9967133837891],
        [28.8366448025959, -81.9623811083985],
        [28.8462683632266, -81.9294221240235],
        [28.8787413067622, -81.9266755419922],
        [28.9112041026263, -81.9266755419922],
        [28.942454975081, -81.9266755419922],
        [28.956875276864, -81.956887944336],
        [28.9520687326739, -81.9596345263672]
      ],
      "page": 1,
      "status": "forSale",
      "sortSelection": "priced",
      "price_min": 200000,
      "price_max": 750000,
      "beds_min": 2
    }
  ]
}
```

### Output data

```json
{
  "results": [
    {
      "zpid": 20473780,
      "streetAddress": "2007 21st St",
      "city": "Santa Monica",
      "state": "CA",
      "zipcode": "90404",
      "price": 2399000,
      "bedrooms": 8,
      "bathrooms": 5,
      "livingArea": 4631,
      "lotAreaValue": 7257.096,
      "lotAreaUnit": "sqft",
      "homeType": "MULTI_FAMILY",
      "homeStatus": "FOR_SALE",
      "latitude": 34.02128,
      "longitude": -118.469246,
      "zestimate": null,
      "rentZestimate": 3898,
      "imgSrc": "https://photos.zillowstatic.com/fp/1bb8a36f22f40c77ecc4c2337f93a9db-p_e.jpg"
    },
    {
      "zpid": 116084354,
      "streetAddress": "1814 12th St APT 2",
      "unit": "Apt 2",
      "city": "Santa Monica",
      "state": "CA",
      "zipcode": "90404",
      "price": 1625000,
      "bedrooms": 3,
      "bathrooms": 3,
      "livingArea": 1603,
      "lotAreaValue": 7501.032,
      "lotAreaUnit": "sqft",
      "homeType": "CONDO",
      "homeStatus": "FOR_SALE",
      "latitude": 34.01633,
      "longitude": -118.48086,
      "zestimate": 1695900,
      "rentZestimate": 5733,
      "imgSrc": "https://photos.zillowstatic.com/fp/eb529587be571f8fc9da63de85cd586a-p_e.jpg"
    }
  ],
  "resultsPerPage": 41,
  "totalPages": 3,
  "totalResultCount": 117
}
```

### How much does Zillow Search by Polygon Scraper cost?

Estimating the cost for this Actor depends on the volume of data and the number of polygon search requests. It is recommended to perform a test run with a small input sample to determine the cost for your specific requirements. The cost can then be extrapolated based on your total expected usage.

### What to consider when using this Actor?

This Actor integrates the full lifecycle of web data extraction ensuring stability and reliability:

1. **Proxy Rotation:** Uses a large proxy pool to avoid blocks by Zillow, ensuring smooth data retrieval.

2. **Geo Targeting:** Determines appropriate proxy location based on the provided polygon coordinates to minimize geo-restriction issues.

3. **Captcha and Blocking Handling:** Automatically manages captchas or temporary access blocks without user intervention.

4. **Stability and Reliability:** Designed to handle large scale requests with error handling and retries for consistent and dependable operation.

### More Zillow Actors by Axesso

Looking for a different slice of Zillow data? Axesso offers a full suite of real-time Zillow Actors - each one dedicated to a specific endpoint:

| Actor | What it does |
|---|---|
| [Zillow Accessibility Scores Scraper](https://apify.com/axesso_data/zillow-accessibility-scores-scraper) | The Zillow Accessibility Scores Scraper retrieves real-time walk, transit, and bike scores for any property listed on Zillow using ZPID ... |
| [Zillow Market Data Scraper](https://apify.com/axesso_data/zillow-market-data-scraper) | The Zillow Market Data Scraper retrieves real-time rental market data for any city, neighborhood, or ZIP code on Zillow, including ... |
| [Zillow Nearby Schools Scraper](https://apify.com/axesso_data/zillow-nearby-schools-scraper) | The Zillow Nearby Schools Scraper retrieves real-time data on schools near any property listed on Zillow using ZPID or URL. |
| [Zillow Price and Tax History Scraper](https://apify.com/axesso_data/zillow-price-tax-history-scraper) | The Zillow Price and Tax History Scraper retrieves real-time price and tax history for any property listed on Zillow using ZPID or URL. |
| [Zillow Property Details Scraper V2](https://apify.com/axesso_data/zillow-property-details-scraper-v2) | The Zillow Property Details Scraper V2 fetches detailed, real-time property data by ZPID or URL from Zillow. |
| [Zillow Property Photos Scraper](https://apify.com/axesso_data/zillow-property-photos-scraper) | The Zillow Property Photos Scraper retrieves real-time photo galleries for any property listed on Zillow using ZPID or URL. |
| [Zillow Property Search Scraper](https://apify.com/axesso_data/zillow-property-search-scraper) | The Zillow Property Search Scraper returns real-time listings by neighborhood, city, or ZIP code. |
| [Zillow Rent Estimate Scraper](https://apify.com/axesso_data/zillow-rent-estimate-scraper) | The Zillow Rent Estimate Scraper retrieves real-time rent zestimates, market summaries, and comparable rental floorplans for any ... |
| [Zillow Search by Address Scraper](https://apify.com/axesso_data/zillow-search-by-address-scraper) | The Zillow Search by Address Scraper retrieves real-time property data by address from Zillow, providing accurate details including ... |
| [Zillow Search by Coordinates Scraper](https://apify.com/axesso_data/zillow-search-by-coordinates-scraper) | The Zillow Search by Coordinates Scraper retrieves real-time property listings within a radius of any latitude and longitude point. |
| [Zillow Search by MLS Scraper](https://apify.com/axesso_data/zillow-search-by-mls-scraper) | The Zillow Search by MLS Scraper retrieves real-time property listings by MLS number from Zillow, returning matching addresses and ZPIDs. |
| [Zillow Similar Properties Scraper](https://apify.com/axesso_data/zillow-similar-properties-scraper) | The Zillow Similar Properties Scraper retrieves real-time listings of comparable homes for sale near any property on Zillow using ... |
| [Zillow Similar Rental Properties Scraper](https://apify.com/axesso_data/zillow-similar-rental-properties-scraper) | The Zillow Similar Rental Properties Scraper retrieves real-time listings of comparable rental homes near any property on Zillow using ... |
| [Zillow Similar Sold Properties Scraper](https://apify.com/axesso_data/zillow-similar-sold-properties-scraper) | The Zillow Similar Sold Properties Scraper retrieves real-time data on recently sold comparable homes near any property on Zillow using ... |
| [Zillow Zestimate History Scraper](https://apify.com/axesso_data/zillow-zestimate-history-scraper) | The Zillow Zestimate History Scraper retrieves historical Zestimate value estimates for any property listed on Zillow using ZPID or URL. |

All Axesso Actors are built and maintained to the same standards: real-time data without caching, high availability and active maintenance, consistent input patterns, and responsive support when you need help. If you are missing a specific endpoint, reach out - the portfolio is continuously growing.

### Where else you can find Axesso - Data Service solutions?

Axesso APIs and Actors are available through the Axesso own [API Portal](https://axesso.developer.azure-api.net/apis) and on [RapidAPI](https://rapidapi.com/search?term=axesso\&sortBy=ByRelevance). Our track record includes thousands of subscribers and stable service for over 5 years.

- **Direct API access**: You can also consume the same real-time Zillow data directly via the [Axesso Zillow API](https://axesso.de/zillow-api/) - ideal for high-volume or backend integrations.

### Use cases for our Axesso Actors

1. **Market Research:** Gather property listings within a specific map area including price, size, and status.

2. **Price Monitoring:** Track price changes for properties located within a defined polygon.

3. **Inventory Management:** Automate the collection of property listings and status for a given area.

4. **Property Valuation:** Use Zestimates and rent Zestimates to assess property values within a map area.

5. **Agent Insights:** Retrieve listing data to identify agents and listing types active in a region.

6. **Content Aggregation:** Collect property data for real estate websites or applications covering specific neighborhoods.

7. **Lead Generation:** Extract listing information for buyer or seller outreach within a target area.

8. **Competitive Analysis:** Monitor market trends and competitor listings within a defined map region.

9. **Data Enrichment:** Enhance existing real estate databases with comprehensive, live property data.

# Actor input Schema

## `input` (type: `array`):

List of inputs, each entry refers to one request to be executed. Each entry is sent 1:1 as the JSON request body. Full list of valid parameters can be found in the README tab.

## Actor input object example

```json
{
  "input": [
    {
      "polygon": [
        [
          28.9520687326739,
          -81.9596345263672
        ],
        [
          28.9544720326552,
          -81.9939668017578
        ],
        [
          28.9532703896359,
          -82.0282990771485
        ],
        [
          28.9244267751812,
          -82.0406586962891
        ],
        [
          28.8943728089739,
          -82.0502717333985
        ],
        [
          28.8643101397807,
          -82.0571381884766
        ],
        [
          28.8426596323051,
          -82.0324189501953
        ],
        [
          28.8390507762033,
          -81.9967133837891
        ],
        [
          28.8366448025959,
          -81.9623811083985
        ],
        [
          28.8462683632266,
          -81.9294221240235
        ],
        [
          28.8787413067622,
          -81.9266755419922
        ],
        [
          28.9112041026263,
          -81.9266755419922
        ],
        [
          28.942454975081,
          -81.9266755419922
        ],
        [
          28.956875276864,
          -81.956887944336
        ],
        [
          28.9520687326739,
          -81.9596345263672
        ]
      ],
      "page": 1,
      "status": "forSale",
      "sortSelection": "priced"
    },
    {
      "polygon": [
        [
          28.9520687326739,
          -81.9596345263672
        ],
        [
          28.9544720326552,
          -81.9939668017578
        ],
        [
          28.9532703896359,
          -82.0282990771485
        ],
        [
          28.9244267751812,
          -82.0406586962891
        ],
        [
          28.8943728089739,
          -82.0502717333985
        ],
        [
          28.8643101397807,
          -82.0571381884766
        ],
        [
          28.8426596323051,
          -82.0324189501953
        ],
        [
          28.8390507762033,
          -81.9967133837891
        ],
        [
          28.8366448025959,
          -81.9623811083985
        ],
        [
          28.8462683632266,
          -81.9294221240235
        ],
        [
          28.8787413067622,
          -81.9266755419922
        ],
        [
          28.9112041026263,
          -81.9266755419922
        ],
        [
          28.942454975081,
          -81.9266755419922
        ],
        [
          28.956875276864,
          -81.956887944336
        ],
        [
          28.9520687326739,
          -81.9596345263672
        ]
      ],
      "page": 1,
      "status": "forSale",
      "sortSelection": "priced",
      "price_min": 200000,
      "price_max": 750000,
      "beds_min": 2
    }
  ]
}
```

# Actor output Schema

## `results` (type: `string`):

No description

# 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 = {
    "input": [
        {
            "polygon": [
                [
                    28.9520687326739,
                    -81.9596345263672
                ],
                [
                    28.9544720326552,
                    -81.9939668017578
                ],
                [
                    28.9532703896359,
                    -82.0282990771485
                ],
                [
                    28.9244267751812,
                    -82.0406586962891
                ],
                [
                    28.8943728089739,
                    -82.0502717333985
                ],
                [
                    28.8643101397807,
                    -82.0571381884766
                ],
                [
                    28.8426596323051,
                    -82.0324189501953
                ],
                [
                    28.8390507762033,
                    -81.9967133837891
                ],
                [
                    28.8366448025959,
                    -81.9623811083985
                ],
                [
                    28.8462683632266,
                    -81.9294221240235
                ],
                [
                    28.8787413067622,
                    -81.9266755419922
                ],
                [
                    28.9112041026263,
                    -81.9266755419922
                ],
                [
                    28.942454975081,
                    -81.9266755419922
                ],
                [
                    28.956875276864,
                    -81.956887944336
                ],
                [
                    28.9520687326739,
                    -81.9596345263672
                ]
            ],
            "page": 1,
            "status": "forSale",
            "sortSelection": "priced"
        },
        {
            "polygon": [
                [
                    28.9520687326739,
                    -81.9596345263672
                ],
                [
                    28.9544720326552,
                    -81.9939668017578
                ],
                [
                    28.9532703896359,
                    -82.0282990771485
                ],
                [
                    28.9244267751812,
                    -82.0406586962891
                ],
                [
                    28.8943728089739,
                    -82.0502717333985
                ],
                [
                    28.8643101397807,
                    -82.0571381884766
                ],
                [
                    28.8426596323051,
                    -82.0324189501953
                ],
                [
                    28.8390507762033,
                    -81.9967133837891
                ],
                [
                    28.8366448025959,
                    -81.9623811083985
                ],
                [
                    28.8462683632266,
                    -81.9294221240235
                ],
                [
                    28.8787413067622,
                    -81.9266755419922
                ],
                [
                    28.9112041026263,
                    -81.9266755419922
                ],
                [
                    28.942454975081,
                    -81.9266755419922
                ],
                [
                    28.956875276864,
                    -81.956887944336
                ],
                [
                    28.9520687326739,
                    -81.9596345263672
                ]
            ],
            "page": 1,
            "status": "forSale",
            "sortSelection": "priced",
            "price_min": 200000,
            "price_max": 750000,
            "beds_min": 2
        }
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("axesso_data/zillow-search-by-polygon-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 = { "input": [
        {
            "polygon": [
                [
                    28.9520687326739,
                    -81.9596345263672,
                ],
                [
                    28.9544720326552,
                    -81.9939668017578,
                ],
                [
                    28.9532703896359,
                    -82.0282990771485,
                ],
                [
                    28.9244267751812,
                    -82.0406586962891,
                ],
                [
                    28.8943728089739,
                    -82.0502717333985,
                ],
                [
                    28.8643101397807,
                    -82.0571381884766,
                ],
                [
                    28.8426596323051,
                    -82.0324189501953,
                ],
                [
                    28.8390507762033,
                    -81.9967133837891,
                ],
                [
                    28.8366448025959,
                    -81.9623811083985,
                ],
                [
                    28.8462683632266,
                    -81.9294221240235,
                ],
                [
                    28.8787413067622,
                    -81.9266755419922,
                ],
                [
                    28.9112041026263,
                    -81.9266755419922,
                ],
                [
                    28.942454975081,
                    -81.9266755419922,
                ],
                [
                    28.956875276864,
                    -81.956887944336,
                ],
                [
                    28.9520687326739,
                    -81.9596345263672,
                ],
            ],
            "page": 1,
            "status": "forSale",
            "sortSelection": "priced",
        },
        {
            "polygon": [
                [
                    28.9520687326739,
                    -81.9596345263672,
                ],
                [
                    28.9544720326552,
                    -81.9939668017578,
                ],
                [
                    28.9532703896359,
                    -82.0282990771485,
                ],
                [
                    28.9244267751812,
                    -82.0406586962891,
                ],
                [
                    28.8943728089739,
                    -82.0502717333985,
                ],
                [
                    28.8643101397807,
                    -82.0571381884766,
                ],
                [
                    28.8426596323051,
                    -82.0324189501953,
                ],
                [
                    28.8390507762033,
                    -81.9967133837891,
                ],
                [
                    28.8366448025959,
                    -81.9623811083985,
                ],
                [
                    28.8462683632266,
                    -81.9294221240235,
                ],
                [
                    28.8787413067622,
                    -81.9266755419922,
                ],
                [
                    28.9112041026263,
                    -81.9266755419922,
                ],
                [
                    28.942454975081,
                    -81.9266755419922,
                ],
                [
                    28.956875276864,
                    -81.956887944336,
                ],
                [
                    28.9520687326739,
                    -81.9596345263672,
                ],
            ],
            "page": 1,
            "status": "forSale",
            "sortSelection": "priced",
            "price_min": 200000,
            "price_max": 750000,
            "beds_min": 2,
        },
    ] }

# Run the Actor and wait for it to finish
run = client.actor("axesso_data/zillow-search-by-polygon-scraper").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "input": [
    {
      "polygon": [
        [
          28.9520687326739,
          -81.9596345263672
        ],
        [
          28.9544720326552,
          -81.9939668017578
        ],
        [
          28.9532703896359,
          -82.0282990771485
        ],
        [
          28.9244267751812,
          -82.0406586962891
        ],
        [
          28.8943728089739,
          -82.0502717333985
        ],
        [
          28.8643101397807,
          -82.0571381884766
        ],
        [
          28.8426596323051,
          -82.0324189501953
        ],
        [
          28.8390507762033,
          -81.9967133837891
        ],
        [
          28.8366448025959,
          -81.9623811083985
        ],
        [
          28.8462683632266,
          -81.9294221240235
        ],
        [
          28.8787413067622,
          -81.9266755419922
        ],
        [
          28.9112041026263,
          -81.9266755419922
        ],
        [
          28.942454975081,
          -81.9266755419922
        ],
        [
          28.956875276864,
          -81.956887944336
        ],
        [
          28.9520687326739,
          -81.9596345263672
        ]
      ],
      "page": 1,
      "status": "forSale",
      "sortSelection": "priced"
    },
    {
      "polygon": [
        [
          28.9520687326739,
          -81.9596345263672
        ],
        [
          28.9544720326552,
          -81.9939668017578
        ],
        [
          28.9532703896359,
          -82.0282990771485
        ],
        [
          28.9244267751812,
          -82.0406586962891
        ],
        [
          28.8943728089739,
          -82.0502717333985
        ],
        [
          28.8643101397807,
          -82.0571381884766
        ],
        [
          28.8426596323051,
          -82.0324189501953
        ],
        [
          28.8390507762033,
          -81.9967133837891
        ],
        [
          28.8366448025959,
          -81.9623811083985
        ],
        [
          28.8462683632266,
          -81.9294221240235
        ],
        [
          28.8787413067622,
          -81.9266755419922
        ],
        [
          28.9112041026263,
          -81.9266755419922
        ],
        [
          28.942454975081,
          -81.9266755419922
        ],
        [
          28.956875276864,
          -81.956887944336
        ],
        [
          28.9520687326739,
          -81.9596345263672
        ]
      ],
      "page": 1,
      "status": "forSale",
      "sortSelection": "priced",
      "price_min": 200000,
      "price_max": 750000,
      "beds_min": 2
    }
  ]
}' |
apify call axesso_data/zillow-search-by-polygon-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,axesso_data/zillow-search-by-polygon-scraper"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/BH4tiOJgL64xRP0Nm/builds/pXfsEduhpH1JekRse/openapi.json