Zillow Sold Listings Actor

This Apify actor retrieves sold property listings for a specific Zillow agent via the RapidAPI Zillow API. It handles pagination and rate limiting to collect data efficiently within the API's constraints.

Key Features

• Fetches sold listings using an agent's Zillow User ID (ZUID).
• Supports pagination to gather multiple pages of results.
• Enforces a rate limit of 3 requests per second to comply with the API.
• Configurable limit for the number of records fetched (up to 50).
• Outputs data to an Apify dataset for easy access and further processing.

Input

The actor requires the following input parameters, provided via an input.json file or the Apify Console:

{
  "rapidApiKey": "YOUR_RAPIDAPI_KEY",
  "zuid": "AGENT_ZUID",
  "maxRecords": 50
}

• rapidApiKey (Required): Your personal API key from RapidAPI.
• zuid (Required): The encoded Zillow User ID of the target agent.
• maxRecords (Optional): The maximum number of listing records to retrieve. Must be between 1 and 50. Defaults to 50 if not specified.

Output

The actor returns an array of objects, each representing a sold property listing. Each object contains detailed information such as:
* Property details (type, bedrooms, bathrooms, square footage).
* Sale price and date.
* Location and address data.
* Relevant agent information.

How to Use

Running on the Apify Platform

1. Push the actor to your Apify account: apify push
2. Configure the input fields (rapidApiKey, zuid, maxRecords) in the Apify Console.
3. Start the run. Results will be available in the dataset associated with the run.

Running Locally

1. Clone the actor repository.
2. Install dependencies with npm install.
3. Create an input.json file in the root directory with your configuration (see Input section above).
4. Execute the actor using apify run.

Notes

• Rate Limiting: The actor is hard-coded to respect the API's rate limit of 3 requests per second. Do not modify this.
• Error Handling: The code includes handling for common issues like API failures, invalid responses, and network problems.
• Dependencies: Main dependencies are axios for HTTP requests and the apify SDK.