Zillow Price History Scraper

This actor scrapes property price history information from Zillow.

Features

• Search price history using ZPID, URL, or address
• Returns detailed price history information including:
  • Sale prices and dates
  • Price changes and rates
  • Price per square foot
  • Event information (sale, listing, etc.)
  • Agent information (if applicable)

Input Parameters

• byzpid (string, required): Zillow Property ID
• byurl (string, optional): Zillow property URL
• byaddress (string, optional): Property address
• maxItems (integer, optional): Maximum number of price history records to scrape (default: 20, min: 20, max: 100)

Output Data

The output includes the following fields:

• date: Date of the price record
• price: Property price
• time: Timestamp
• pricePerSquareFoot: Price per square foot
• priceChangeRate: Rate of price change
• event: Event type (sale, listing, etc.)
• source: Data source
• buyerAgent: Buyer's agent information
• sellerAgent: Seller's agent information
• showCountyLink: County link availability
• postingIsRental: Rental status
• attributeSource: Additional attribute information
• scrapedAt: Data scraping timestamp

Example Usage

{
    "byzpid": "44471319",
    "maxItems": 20
}

Output Example

[
  {
    "date": "2025-03-31",
    "price": 580000,
    "time": 1743379200000,
    "pricePerSquareFoot": 290,
    "priceChangeRate": 0,
    "event": "Listing removed",
    "source": "realMLS",
    "buyerAgent": null,
    "sellerAgent": null,
    "showCountyLink": false,
    "postingIsRental": false,
    "attributeSource": {
      "infoString1": "2012734",
      "infoString2": "realMLS",
      "infoString3": "https://photos.zillowstatic.com/fp/7e93ce7b14e79dd30af883babea7400f-zillow_web_logo_inf_11.jpg"
    },
    "scrapedAt": "2025-06-04T05:43:34.481Z"
  },
  ...
]

Notes

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