Skip to main content
GET
/
api
/
v1
/
search
/
by-mapbounds
Search by Mapbounds
curl --request GET \
  --url https://us-property-data.p.rapidapi.com/api/v1/search/by-mapbounds \
  --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

​
north
string
required

Northern latitude boundary of the search area

Minimum string length: 1
Example:

"39.19273520528339"

​
south
string
required

Southern latitude boundary of the search area

Minimum string length: 1
Example:

"38.55961279471661"

​
east
string
required

Eastern longitude boundary of the search area

Minimum string length: 1
Example:

"-76.60554352221475"

​
west
string
required

Western longitude boundary of the search area

Minimum string length: 1
Example:

"-77.41879847778524"

​
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[]