Zillow Search Nearby Scraper

This actor scrapes nearby property information from Zillow based on a reference property.

Features

• Search nearby properties using ZPID, URL, address, or Lot ID
• Returns detailed property information including:
  • Basic information (price, bedrooms, bathrooms, etc.)
  • Location details (address, coordinates)
  • Property type and status
  • Listing details (photos, square footage, etc.)
  • Agent information (if applicable)

Input Parameters

• byzpid (string, required): Zillow Property ID
• byurl (string, optional): Zillow property URL
• byaddress (string, optional): Property address
• bylotid (string, optional): Zillow Lot ID
• maxItems (integer, optional): Maximum number of properties to scrape (default: 50, min: 20, max: 1000)

Output Data

The output includes the following fields:

• zpid: Zillow Property ID
• miniCardPhotos: Array of property photos
• price: Property price
• currency: Currency unit
• bedrooms: Number of bedrooms
• bathrooms: Number of bathrooms
• livingArea: Living area size
• address: Address information
• latitude: Latitude coordinate
• longitude: Longitude coordinate
• homeStatus: Property status
• homeType: Property type
• hdpUrl: Detail page URL
• attributionInfo: Agent information
• scrapedAt: Data scraping timestamp

Example Usage

const input = {
    "byzpid": "44471319",
    "maxItems": 50
};

Output Example

[
  {
    "zpid": 44471320,
    "miniCardPhotos": [
      {
        "url": "https://photos.zillowstatic.com/fp/333bab14bf220cac9f8c7e82cb983108-p_c.jpg"
      }
    ],
    "price": 376300,
    "currency": "USD",
    "bedrooms": 2,
    "bathrooms": 3,
    "livingArea": 1210,
    "livingAreaValue": 1210,
    "livingAreaUnits": "Square Feet",
    "livingAreaUnitsShort": "sqft",
    "listingMetadata": {
      "comminglingCategoryIsRulesApplicable": false
    },
    "resoFacts": {
      "bathroomsOneQuarter": null,
      "bathroomsHalf": null,
      "bathroomsThreeQuarter": null,
      "bathroomsFull": null
    },
    "lotSize": 8750,
    "lotAreaValue": 8750,
    "lotAreaUnits": "Square Feet",
    "address": {
      "streetAddress": "2758 Downing St",
      "city": "Jacksonville",
      "state": "FL",
      "zipcode": "32205"
    },
    "parentRegion": null,
    "formattedChip": {
      "location": [
        {
          "fullValue": "2758 Downing St"
        },
        {
          "fullValue": null
        }
      ]
    },
    "latitude": 30.311153,
    "longitude": -81.69726,
    "homeStatus": "OTHER",
    "homeType": "SINGLE_FAMILY",
    "hdpUrl": "/homedetails/2758-Downing-St-Jacksonville-FL-32205/44471320_zpid/",
    "hdpTypeDimension": "Zestimate",
    "propertyTypeDimension": "Single Family",
    "listingTypeDimension": "Unknown Listed By",
    "listing_sub_type": {
      "is_newHome": false,
      "is_forAuction": false,
      "is_bankOwned": false,
      "is_foreclosure": false,
      "is_FSBO": false,
      "is_comingSoon": false,
      "is_FSBA": false
    },
    "providerListingID": null,
    "attributionInfo": {
      "mlsId": null,
      "mlsName": null,
      "providerLogo": null,
      "agentName": null,
      "agentPhoneNumber": null,
      "brokerName": null,
      "brokerPhoneNumber": null,
      "trueStatus": null
    },
    "isShowcaseListing": false,
    "isPremierBuilder": false,
    "state": "FL",
    "newConstructionType": null,
    "scrapedAt": "2025-06-04T04:04:02.251Z"
  },
  ...
]

Notes

1. Ensure valid query parameters are provided
2. API may have rate limits
3. Returned data may vary based on property type and status