Back to blog

March 9, 2026 • 9 min read

Search by Location API

How to Search Zillow Properties by Location Using API (Step-by-Step Guide)

Developers often need a reliable way to search Zillow property listings by location when building real estate platforms or analytics tools.

Typical use cases include:

  • Real estate search websites
  • Property investment analysis tools
  • Housing market dashboards
  • Lead generation systems for agents

In this tutorial, you will learn how to search Zillow properties by location using an API and retrieve structured JSON listing data that can be used directly inside your application.

This guide uses the US Property Data API available on RapidAPI.

Try the API Playground

Step 1 — Get Your API Key

Before making requests, you need to subscribe to the API and obtain your API key.

  1. Visit the API page
  2. Subscribe to a plan
  3. Copy your RapidAPI key

Subscribe to the US Property Data API

You will use this key in the request headers.

Step 2 — Search Zillow Properties by Location

The API provides an endpoint that allows developers to search property listings using a location query.

Supported location inputs include:

  • City name
  • ZIP code
  • Neighborhood
  • Full address

cURL Example

curl --request GET \
  --url 'https://us-property-data.p.rapidapi.com/api/v1/search/by-location?location=Rosedale%2C%20NY&page=1&listing_status=for_sale&sort_by=globalrelevanceex' \
  --header 'x-rapidapi-host: us-property-data.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_API_KEY'

Replace <YOUR_API_KEY> with your RapidAPI key.

Example JSON Response

{
  "success": true,
  "message": "success",
  "process_time": 1823,
  "data": [
    {
      "zpid": "31231490",
      "palsId": "778001_952189",
      "id": "31231490",
      "rawHomeStatusCd": "ForSale",
      "marketingStatusSimplifiedCd": "For Sale by Agent",
      "imgSrc": "https://photos.zillowstatic.com/fp/3b2153a354f8fe61d5beada2dbbc5242-p_e.jpg",
      "hasImage": true,
      "detailUrl": "https://www.zillow.com/homedetails/7-N-Terrace-Pl-Valley-Stream-NY-11580/31231490_zpid/",
      "statusType": "FOR_SALE",
      "statusText": "House for sale",
      "countryCurrency": "$",
      "price": "$849,000",
      "unformattedPrice": 849000,
      "address": "7 N Terrace Place, Valley Stream, NY 11580",
      "addressStreet": "7 N Terrace Place",
      "addressCity": "Valley Stream",
      "addressState": "NY",
      "addressZipcode": "11580",
      "isUndisclosedAddress": false,
      "shouldShowRequestOnPrice": false,
      "beds": 4,
      "baths": 2,
      "area": 2655,
      "latLong": {
        "latitude": 40.669308,
        "longitude": -73.71369
      },
      "isZillowOwned": false,
      "flexFieldText": "Open: Sat 11am-1pm (1/24)",
      "contentType": "openHouse",
      "hdpData": {
        "homeInfo": {
          "zpid": 31231490,
          "streetAddress": "7 N Terrace Place",
          "zipcode": "11580",
          "city": "Valley Stream",
          "state": "NY",
          "latitude": 40.669308,
          "longitude": -73.71369,
          "price": 849000,
          "bathrooms": 2,
          "bedrooms": 4,
          "livingArea": 2655,
          "homeType": "SINGLE_FAMILY",
          "homeStatus": "FOR_SALE",
          "daysOnZillow": 5,
          "isFeatured": false,
          "shouldHighlight": false,
          "listing_sub_type": {
            "is_FSBA": true,
            "is_openHouse": true
          },
          "openHouse": "Sat. 11am-1pm",
          "isUnmappable": false,
          "isPreforeclosureAuction": false,
          "homeStatusForHDP": "FOR_SALE",
          "priceForHDP": 849000,
          "open_house_info": {
            "open_house_showing": [
              {
                "open_house_start": 1769281200000,
                "open_house_end": 1769288400000
              },
              {
                "open_house_start": 1769374800000,
                "open_house_end": 1769382000000
              }
            ]
          },
          "timeOnZillow": 473416000,
          "isNonOwnerOccupied": true,
          "isPremierBuilder": false,
          "isZillowOwned": false,
          "currency": "USD",
          "country": "USA",
          "taxAssessedValue": 453000,
          "lotAreaValue": 6000,
          "lotAreaUnit": "sqft",
          "isShowcaseListing": false
        }
      },
      "isSaved": false,
      "isUserClaimingOwner": false,
      "isUserConfirmedClaim": false,
      "pgapt": "ForSale",
      "sgapt": "For Sale (Broker)",
      "shouldShowZestimateAsPrice": false,
      "has3DModel": false,
      "hasVideo": false,
      "isHomeRec": false,
      "hasAdditionalAttributions": true,
      "isFeaturedListing": false,
      "isShowcaseListing": false,
      "list": true,
      "relaxed": false,
      "info3String": "https://photos.zillowstatic.com/fp/464ad42e5f4f4a61544ab7d3b6721129-zillow_web_48_23.jpg",
      "brokerName": "Listing by: Keller Williams Legendary",
      "carouselPhotosComposable": {
        "baseUrl": "https://photos.zillowstatic.com/fp/{photoKey}-p_e.jpg",
        "communityBaseUrl": null,
        "photoData": [
          {
            "photoKey": "3b2153a354f8fe61d5beada2dbbc5242"
          },
          {
            "photoKey": "e0a5784df8707d4bbbe13dded2043046"
          },
          {
            "photoKey": "00fbeaa1013ace63e5c69ae828cc7c5c"
          },
          {
            "photoKey": "226d0ba16bdf5df71b26649f24562dd1"
          },
          {
            "photoKey": "ddc337cd104aa2d61337a44b5dab027f"
          },
          {
            "photoKey": "ad0744786144c22b2ec89cecdf9e4133"
          },
          {
            "photoKey": "9849f0352e4b0a09fd4cd1d3b204d54b"
          },
          {
            "photoKey": "44cdc38f467d6a62bb856885c9b26f26"
          },
          {
            "photoKey": "03d48e9d0997a96b62c2fb271e448ced"
          },
          {
            "photoKey": "9822518b0d674943dd7e3fab8c0fa0af"
          },
          {
            "photoKey": "b756d5f50aa87ebc3f9762146ef9ed7b"
          },
          {
            "photoKey": "768e1553a7fd27e5554f51ab4220a14a"
          },
          {
            "photoKey": "858931d06cbe6a844804f8b5ecad30b4"
          },
          {
            "photoKey": "75713d0da3683f9cefed078bb3dc99bd"
          },
          {
            "photoKey": "8dd2e78dc3757221d11ec240b0901748"
          },
          {
            "photoKey": "b250b27491a51027f9cf44c8a34878e6"
          },
          {
            "photoKey": "2e2f5d212e69380a01863efaa09a7ff9"
          },
          {
            "photoKey": "555a8711cc3eee11a7b89784ad93fec6"
          },
          {
            "photoKey": "935093a775e9883c5ff3f1788535031e"
          },
          {
            "photoKey": "7bb735d7d95a4a4f93751ba2f2403d8e"
          },
          {
            "photoKey": "851cd047e13021b53ad5961922178d94"
          },
          {
            "photoKey": "221e72a62ffb6220a4467c9abd12e16d"
          },
          {
            "photoKey": "fb0615581b12c60926963b07780ae1e9"
          },
          {
            "photoKey": "b2b9af3fb71bf5a122ca5c1c4ba3428c"
          },
          {
            "photoKey": "2c9cd486a2b990a5ad3b2aa5f1428c27"
          },
          {
            "photoKey": "f2b0b7f9193317a16021e550db5f3c58"
          },
          {
            "photoKey": "69a22181e824d8163fd824e375184994"
          },
          {
            "photoKey": "b41f313d51e908e5a8b968da1a3689d1"
          },
          {
            "photoKey": "b799d2e461bbe0cb19326b2431337871"
          },
          {
            "photoKey": "3044af11e356971df4a7dd57a104de01"
          },
          {
            "photoKey": "9f9e1d2ac915fcffa3d2427aac9c4ab3"
          },
          {
            "photoKey": "96191dde246c20c1fc336dbf12d4ee8c"
          },
          {
            "photoKey": "8992762e591346a099249d97212e9e2e"
          },
          {
            "photoKey": "ed3d79a55bff6608a90fe6a204ed4d95"
          },
          {
            "photoKey": "6b230b0e83a60fe8f4c1aa915bdcff7e"
          },
          {
            "photoKey": "ff22fd86ab861a1083200aa0e7571c21"
          },
          {
            "photoKey": "36fac71dea33fd2b45be14b20484b1b1"
          },
          {
            "photoKey": "63d1d911f67fdda40524b76b4c18378f"
          },
          {
            "photoKey": "b23e103921b0a4d32ad2ecce4dd18091"
          },
          {
            "photoKey": "bfe8b80679090f88ec1423efe45e44fc"
          }
        ],
        "communityPhotoData": null,
        "isStaticUrls": false
      },
      "hasOpenHouse": true,
      "openHouseStartDate": "2026-01-24T11:00:00",
      "openHouseEndDate": "2026-01-24T13:00:00",
      "openHouseDescription": "Open House - 11:00 AM - 1:00 PM",
      "isPaidBuilderNewConstruction": false
    },
    {...}
  ],
  "cost": 1,
  "page": 1,
  "total": 179,
  "has_more": true
}

Parameter

Retrieve property listings based on a specific location and optional filters such as price, bedrooms, property type, and amenities.

Parameter Type Required Description Example
location string Yes Location to search properties in. Can be a full address, neighborhood, city, or ZIP code. Rosedale, NY 11422
page integer No Page number for paginated results. Default is 1. 2
listing_status string No Listing status filter: for_sale, for_rent, or sold. Default is for_sale. for_sale
sort_by string No Sort results by criteria such as relevance, price, recency, bedrooms, bathrooms, size, or lot size. pricea
list_price_range string No Filter properties by price range using min,max format. 50000,1000000
monthly_payment_range string No Monthly payment range filter (only applies when listing_status=for_sale). Format min,max. 1000,3000
monthly_down_payment integer No Estimated down payment used to calculate monthly payments. Only for for_sale. 20000
monthly_credit_score string No Credit score category used for mortgage calculations. CS720_AND_ABOVE
number_of_bedrooms integer No Minimum number of bedrooms. Returns properties with bedrooms >= value. 3
is_extract_match_bedroom boolean No If true, requires exact bedroom match instead of minimum match. true
number_of_bathrooms integer No Minimum number of bathrooms. 2
home_types string No Filter by property types (comma-separated). houses,townhomes
max_hoa integer No Maximum HOA fee allowed. Only applies to for_sale or sold. 500
listing_type string No Listing source or type such as owner posted, agent listed, foreclosure, auction. agent_listed
property_status string No Property marketing status such as coming soon, accepting backup offers, or pending. comming_soon
tours string No Filters listings with tours such as open house or 3D tour. must_have_3d_tour
parking_spots integer No Minimum number of parking spaces. 2
must_have_garage boolean No Only return properties that include a garage. true
square_feet_range string No Filter by living area size using min,max square feet. 800,2500
lot_size_range string No Filter by lot size in square feet using min,max. 1000,5000
year_built_range string No Filter by construction year range using min,max. 1990,2020
basement string No Basement type filter. finished
is_single_story_only boolean No Only return single-story homes. true
fifty_five_plus_communities string No Filter 55+ communities (include, do_not_show, only_show). include
other_amenities string No Filter by additional amenities such as AC, pool, laundry, etc. must_have_pool
view string No Filter properties by view type such as city, mountain, park, or water. water
days_on_zillow string No Filter listings by how recently they were listed. 7
keywords string No Free-text keyword search (MLS number, features, etc.). MLS12345
move_in_date string No Desired move-in date for rental listings (YYYY-MM-DD). 2026-01-31
pets string No Pet policy filters for rentals. allows_cats
sold_in_last string No Filter sold properties by how recently they were sold. 30

Conclusion

You can explore and test the endpoint here:

Open API Playground

And get your API key here:

Subscribe to the API

Search by Location API