Search by Polygon

Search by Polygon

curl --request GET \
  --url https://us-property-data.p.rapidapi.com/api/v1/search/by-polygon \
  --header 'x-rapidapi-key: <api-key>'

{
  "success": true,
  "cost": 1,
  "total": 792,
  "has_more": true,
  "data": [
    {
      "zpid": "456346178",
      "palsId": "6955001_S1787431",
      "id": "456346178",
      "rawHomeStatusCd": "ForSale",
      "marketingStatusSimplifiedCd": "For Sale by Agent",
      "imgSrc": "https://photos.zillowstatic.com/fp/79ae0ba2dffd7afad218b1b9d1499a4a-p_e.jpg",
      "hasImage": true,
      "detailUrl": "https://www.zillow.com/homedetails/33-221st-Bch-UNIT-1-Breezy-Pt-NY-11697/456346178_zpid/",
      "statusType": "FOR_SALE",
      "statusText": "Condo for sale",
      "countryCurrency": "$",
      "price": "$1,200,000",
      "unformattedPrice": 1200000,
      "address": "33 221st Bch UNIT 1, Breezy Pt, NY 11697",
      "addressStreet": "33 221st Bch UNIT 1",
      "addressCity": "Breezy Pt",
      "addressState": "NY",
      "addressZipcode": "11697",
      "isUndisclosedAddress": false,
      "shouldShowRequestOnPrice": false,
      "beds": 4,
      "baths": 3,
      "area": 2800,
      "latLong": {
        "latitude": 40.55535,
        "longitude": -73.92914
      },
      "isZillowOwned": false,
      "flexFieldText": "Private beach",
      "contentType": "homeInsight",
      "hdpData": {
        "homeInfo": {
          "zpid": 456346178,
          "streetAddress": "33 221st Bch UNIT 1",
          "zipcode": "11697",
          "city": "Breezy Pt",
          "state": "NY",
          "latitude": 40.55535,
          "longitude": -73.92914,
          "price": 1200000,
          "datePriceChanged": 1763539200000,
          "bathrooms": 3,
          "bedrooms": 4,
          "livingArea": 2800,
          "homeType": "CONDO",
          "homeStatus": "FOR_SALE",
          "daysOnZillow": 141,
          "isFeatured": false,
          "shouldHighlight": false,
          "rentZestimate": 4572,
          "listing_sub_type": {
            "is_FSBA": true
          },
          "priceReduction": "$195,000 (Nov 19)",
          "isUnmappable": false,
          "isPreforeclosureAuction": false,
          "homeStatusForHDP": "FOR_SALE",
          "priceForHDP": 1200000,
          "priceChange": -195000,
          "timeOnZillow": 12192296000,
          "isNonOwnerOccupied": true,
          "isPremierBuilder": false,
          "isZillowOwned": false,
          "currency": "USD",
          "country": "USA",
          "unit": "Unit 1",
          "isShowcaseListing": false
        }
      },
      "pgapt": "ForSale",
      "sgapt": "For Sale (Broker)",
      "shouldShowZestimateAsPrice": false,
      "has3DModel": false,
      "hasVideo": false,
      "isHomeRec": false,
      "hasAdditionalAttributions": true,
      "isFeaturedListing": false,
      "isShowcaseListing": false,
      "relaxed": true,
      "brokerName": "Listing by: Douglas Elliman",
      "carouselPhotosComposable": {
        "baseUrl": "https://photos.zillowstatic.com/fp/{photoKey}-p_e.jpg",
        "communityBaseUrl": null,
        "photoData": [
          {
            "photoKey": "79ae0ba2dffd7afad218b1b9d1499a4a"
          }
        ],
        "communityPhotoData": null,
        "isStaticUrls": false
      },
      "ma": false,
      "isPaidBuilderNewConstruction": false
    }
  ]
}

GET

api

by-polygon

Search by Polygon

curl --request GET \
  --url https://us-property-data.p.rapidapi.com/api/v1/search/by-polygon \
  --header 'x-rapidapi-key: <api-key>'

{
  "success": true,
  "cost": 1,
  "total": 792,
  "has_more": true,
  "data": [
    {
      "zpid": "456346178",
      "palsId": "6955001_S1787431",
      "id": "456346178",
      "rawHomeStatusCd": "ForSale",
      "marketingStatusSimplifiedCd": "For Sale by Agent",
      "imgSrc": "https://photos.zillowstatic.com/fp/79ae0ba2dffd7afad218b1b9d1499a4a-p_e.jpg",
      "hasImage": true,
      "detailUrl": "https://www.zillow.com/homedetails/33-221st-Bch-UNIT-1-Breezy-Pt-NY-11697/456346178_zpid/",
      "statusType": "FOR_SALE",
      "statusText": "Condo for sale",
      "countryCurrency": "$",
      "price": "$1,200,000",
      "unformattedPrice": 1200000,
      "address": "33 221st Bch UNIT 1, Breezy Pt, NY 11697",
      "addressStreet": "33 221st Bch UNIT 1",
      "addressCity": "Breezy Pt",
      "addressState": "NY",
      "addressZipcode": "11697",
      "isUndisclosedAddress": false,
      "shouldShowRequestOnPrice": false,
      "beds": 4,
      "baths": 3,
      "area": 2800,
      "latLong": {
        "latitude": 40.55535,
        "longitude": -73.92914
      },
      "isZillowOwned": false,
      "flexFieldText": "Private beach",
      "contentType": "homeInsight",
      "hdpData": {
        "homeInfo": {
          "zpid": 456346178,
          "streetAddress": "33 221st Bch UNIT 1",
          "zipcode": "11697",
          "city": "Breezy Pt",
          "state": "NY",
          "latitude": 40.55535,
          "longitude": -73.92914,
          "price": 1200000,
          "datePriceChanged": 1763539200000,
          "bathrooms": 3,
          "bedrooms": 4,
          "livingArea": 2800,
          "homeType": "CONDO",
          "homeStatus": "FOR_SALE",
          "daysOnZillow": 141,
          "isFeatured": false,
          "shouldHighlight": false,
          "rentZestimate": 4572,
          "listing_sub_type": {
            "is_FSBA": true
          },
          "priceReduction": "$195,000 (Nov 19)",
          "isUnmappable": false,
          "isPreforeclosureAuction": false,
          "homeStatusForHDP": "FOR_SALE",
          "priceForHDP": 1200000,
          "priceChange": -195000,
          "timeOnZillow": 12192296000,
          "isNonOwnerOccupied": true,
          "isPremierBuilder": false,
          "isZillowOwned": false,
          "currency": "USD",
          "country": "USA",
          "unit": "Unit 1",
          "isShowcaseListing": false
        }
      },
      "pgapt": "ForSale",
      "sgapt": "For Sale (Broker)",
      "shouldShowZestimateAsPrice": false,
      "has3DModel": false,
      "hasVideo": false,
      "isHomeRec": false,
      "hasAdditionalAttributions": true,
      "isFeaturedListing": false,
      "isShowcaseListing": false,
      "relaxed": true,
      "brokerName": "Listing by: Douglas Elliman",
      "carouselPhotosComposable": {
        "baseUrl": "https://photos.zillowstatic.com/fp/{photoKey}-p_e.jpg",
        "communityBaseUrl": null,
        "photoData": [
          {
            "photoKey": "79ae0ba2dffd7afad218b1b9d1499a4a"
          }
        ],
        "communityPhotoData": null,
        "isStaticUrls": false
      },
      "ma": false,
      "isPaidBuilderNewConstruction": false
    }
  ]
}

Authorizations

x-rapidapi-key

string

header

required

Rapid API Key

Query Parameters

polygon

string

required

Polygon coordinates defining the search area (list of "lng lat" pairs, separated by commas, forming a closed polygon)

Minimum string length: 1

Example:

"-77.012171 38.876174, -77.012171 38.92701, -76.943026 38.92701, -76.943026 38.876174, -77.012171 38.876174"

page

integer

default:1

Page number for pagination

Example:

1

listing_status

enum<string>

default:for_sale

Property listing status

for_sale: For Sale
for_rent: For Rent
sold: Sold

Available options:

for_sale,

for_rent,

sold

Example:

"for_sale"

sort_by

enum<string>

default:globalrelevanceex

Sort results by the specified criteria

globalrelevanceex: Homes for You
priced: Price (High to Low)
pricea: Pirce (Low to High)
days: Newest
beds: Bedrooms
baths: Bathrooms
size: Square Feet
lot: Lot Size

Available options:

globalrelevanceex,

priced,

pricea,

days,

beds,

baths,

size,

lot

Example:

"globalrelevanceex"

list_price_range

string

list_price_range filter in format min,max

Example 50000,1000000 means price from $50,000 to $1,000,000

Example:

"50000,1000000"

monthly_payment_range

string

Only applicable when listing_status = for_sale

monthly_payment_range filter in format min,max

Example 50000,1000000 means price from $50,000 to $1,000,000

Example:

"50000,1000000"

monthly_down_payment

integer

Only applicable when listing_status = for_sale

Down payment is how much you're required to put down on a house is determined by the type of loan you get, but it generally ranges from 3% to 20% of the purchase price of the home

Example:

1000

monthly_credit_score

enum<string>

Only applicable when listing_status = for_sale

Monthly payment credit score

CS720_AND_ABOVE: 720 & above
CS660_719: 660-719
CS620_659: 620-659
CS580_619: 580-619
CS579_AND_BELOW: 579 or below

Available options:

CS720_AND_ABOVE,

CS660_719,

CS620_659,

CS580_619,

CS579_AND_BELOW

number_of_bedrooms

integer

Filter by minimum number of bedrooms. The value represents the lower bound. For example, if 1 is provided, the query will return properties with 1 or more bedrooms (bedrooms >= 1)

Example:

1

is_extract_match_bedroom

boolean

Use exact match bedrooms

Example:

true

number_of_bathrooms

integer

Filter by minimum number of bathrooms. The value represents the lower bound. For example, if 1 is provided, the query will return properties with 1 or more bathrooms (bathrooms >= 1)

Example:

1

home_types

string

default:houses,townhomes,multi_family,condos_co_ops,lots_land,apartments,manufactured

Filter listings by home type

You can use one or multiple values separated by commas ,

houses: Houses
townhomes: Townhomes
multi_family: Multi Family
condos_co_ops: Condos/Co-ops
lots_land: Lots/Land
apartments: Apartments
manufactured: Manufactured

Example:

"houses,townhomes"

max_hoa

integer

Only applicable when listing_status = for_sale or sold

HOA fees are monthly or annual charges that cover the costs of maintaining and improving shared spaces. HOA fees are common within condos and some single-family home neighborhoods. Co-ops also have monthly fees (Common Charges and Maintenance Fees), which may also include real estate taxes and a portion of the building's underlying mortgage

Example:

2000

listing_type

string

default:owner_posted,agent_listed,new_construction,foreclosures,auctions

Only applicable when listing_status = for_sale

Filter listings by listing type

You can use one or multiple values separated by commas ,

owner_posted: Owner Posted
agent_listed: Agent Listed
new_construction: New Construction
foreclosures: Foreclosures - These properties are currently listed for sale. They are owned by a bank or a lender who took ownership through foreclosure proceedings. These are also known as bank-owned or real estate owned (REO).
auctions: Auctions
foreclosed: Foreclosed - These properties are owned by a bank or a lender who took ownership through foreclosure proceedings. They may soon be listed for sale.
pre_foreclosures: Pre Foreclosures - The lender initiated foreclosure proceedings on these properties because the owner(s) were in default on their loan obligations. Pre-foreclosures also include properties for which a foreclosure auction is scheduled.

Example:

"owner_posted,agent_listed"

property_status

string

default:comming_soon

Only applicable when listing_status = for_sale

Filter listings by property status

You can use one or multiple values separated by commas ,

comming_soon: Comming soon - Coming Soon listings are homes that will soon be on the market. The listing agent for these homes has added a Coming Soon note to alert buyers in advance.
accepting_backup_offers: Accepting backup offers
pending_and_under_contract: Pending & under contract - Sellers of these homes have accepted a buyer's offer; however, the home has not closed.

Example:

"comming_soon,accepting_backup_offers"

tours

string

Only applicable when listing_status = for_sale or for_rent

Filter listing by tours

You can use one or multiple values separated by commas ,

must_have_open_house: Must have open house (For Sale Only)
must_have_3d_tour: Must have 3D Tour
must_have_showcase: Must have Showcase (For Sale Only)
instant_tour_available: Instant Tour Available (For Rent Only)

Example:

"must_have_open_house,must_have_3d_tour"

parking_spots

integer

Filter by minimum number of parking spots. The value represents the lower bound. For example, if 1 is provided, the query will return properties with 1 or more parking spots (parking spots >= 1)

Example:

1

must_have_garage

boolean

Must have garage

Example:

true

square_feet_range

string

square_feet_range filter in format min,max

Example 500,2000 square feet from 500 to 2000

Example:

"500,2000"

lot_size_range

string

lot_size_range filter in format min,max

Example: 1000,2000 lot size from 1000 sqft to 2000 sqft

Example:

"1000,2000"

year_built_range

string

year_built_range filter in format min,max

Example: 2015,2020 year built from 2015 to 2020

Example:

"2015,2020"

basement

string

Filter listings by basement

You can use one or multiple values separated by commas ,

finished: Finished
unfinished: Unfinished

Example:

"finished,unfinished"

is_single_story_only

boolean

Single-story only

Example:

true

fifty_five_plus_communities

enum<string>

default:include

55+ Communities

include: Include
do_not_show: Don't show
only_show: Only show

Available options:

include,

do_not_show,

only_show

Example:

"include"

other_amenities

string

Filter listings by other amenities

You can use one or multiple values separated by commas ,

must_have_ac: Must have A/C
must_have_pool: Must have pool
waterfront: Waterfront
on_site_parking: On-site Parking (For Rent Only)
in_unit_laundry: In-unit Laundry (For Rent Only)
accepts_zillow_applications: Accepts Zillow Applications (For Rent Only)
income_restricted: Income restricted (For Rent Only)
hardwood_floors: Hardwood Floors (For Rent Only)
disabled_access: Disabled Access (For Rent Only)
utilities_included: Utilities Included (For Rent Only)
short_term_lease_available: Short term lease available (For Rent Only)
furnished: Furnished (For Rent Only)
outdoor_space: Outdoor space (For Rent Only)
controlled_access: Controlled access (For Rent Only)
high_speed_internet: High speed internet (For Rent Only)
elevator: Elevator (For Rent Only)
apartment_community: Apartment Community (For Rent Only)

Example:

"must_have_ac,must_have_pool"

view

string

Filter listings by view

You can use one or multiple values separated by commas ,

city: City
mountain: Mountain
park: Park
water: Water

Example:

"city, mountain"

days_on_zillow

enum<string>

Only applicable when listing_status = for_sale or for_rent

Days on Zillow filter

1: Listed within the last 1 day
7: Listed within the last 7 days
30: Listed within the last 30 days
90: Listed within the last 90 days
6m: Listed within the last 6 months
12m: Listed within the last 12 months
24m: Listed within the last 24 months
36m: Listed within the last 36 months

Available options:

1,

7,

30,

90,

6m,

12m,

24m,

36m

keywords

string

MLS #, yard, etc.

move_in_date

string

Only applicable when listing_status = for_rent

Desired move-in date. Format YYYY-MM-DD (ISO 8601)

Pattern: ^\d{4}-(0[1-9]|1[0-2])-(0[1-9]|[12]\d|3[01])$

Example:

"2026-01-31"

pets

string

Only applicable when listing_status = for_rent

Filter listings by pets

You can use one or multiple values separated by commas ,

allows_large_dogs: Allows large dogs
allows_small_dogs: Allows small dogs
allows_cats: Allows cats
no_pets: No pets

Example:

"allows_large_dogs,allows_cats"

sold_in_last

enum<string>

Only applicable when listing_status = sold

Filter listings by how recently they were sold

1: Sold within the last 1 day
7: Sold within the last 7 days
30: Sold within the last 30 days
90: Sold within the last 90 days
6m: Sold within the last 6 months
12m: Sold within the last 12 months
24m: Sold within the last 24 months
36m: Sold within the last 36 months

Available options:

1,

7,

30,

90,

6m,

12m,

24m,

36m

Response

Success

success

boolean

Example:

true

cost

number

Cost of the request

Example:

1

total

number

Total number of properties matching the search criteria

Example:

792

has_more

boolean

Whether there are more data to fetch

Example:

true

data

object[]

Show child attributes

Search by URL Search by Coordinates

🔌 Zillow API

🔌 Realtor API

Authorizations

Query Parameters

Response