Zillow Sales Metadata History

An Apify actor that scrapes real estate sales data directly from the Zillow Metadata Sales History API.

Overview

This actor efficiently queries Zillow's API to fetch historical property sales records. It allows you to search by location and date range, returning structured data optimized for storage and analysis.

Key Features

• Flexible Search: Find properties by partial address and filter results by a custom date range.
• High Performance: Queries are executed quickly, typically in under 25ms.
• Pagination Control: Manage data volume with configurable page limits and results per page.
• Structured Output: Returns clean, comprehensive property data, including Zillow IDs, sale prices, dates, and full URLs.
• Optimized Dataset: Output is formatted for easy integration into PostgreSQL or similar databases.

How to Use

Configure the actor run using the input parameters below. You can search by address, date range, or a combination of both.

Input Parameters

Provide input as a JSON object with the following optional fields:

{
  "address": "main street",
  "from_date": "2024-01-01",
  "to_date": "2024-12-31",
  "max_pages": 10,
  "limit_per_page": 200
}

• address: A partial address or location name (e.g., "los angeles").
• from_date / to_date: Start and end dates for the sale period (format: YYYY-MM-DD).
• max_pages: The maximum number of result pages to scrape (default: 5).
• limit_per_page: Number of results per page, up to a maximum of 200 (default: 200).

Usage Examples

Search by location:

{ "address": "boston", "max_pages": 5 }

Search by date range:

{ "from_date": "2024-01-01", "to_date": "2024-06-30" }

Combined search:

{
  "address": "chicago",
  "from_date": "2023-07-01",
  "to_date": "2024-07-01",
  "max_pages": 15,
  "limit_per_page": 200
}

Output

The actor outputs an array of property records, each containing these key fields:

• zpid: The unique Zillow Property ID.
• address: The full street address.
• city, state, zip_code: Geographic components.
• sale_price: The recorded sale price in USD.
• date_of_sale: The date the sale was recorded.
• full_url: Direct link to the property listing on Zillow.
• scraped_at: UTC timestamp of when the data was fetched.