Zillow Agent Active Listings Scraper

This Apify actor fetches active listings for a Zillow agent using the RapidAPI Zillow API endpoint. It supports pagination and rate limiting to efficiently collect data while respecting API constraints.

Features

• Fetches active listings for any Zillow agent using their ZUID
• Supports pagination to collect multiple pages of listings
• Implements rate limiting (3 requests per second) to respect API constraints
• Configurable maximum number of records to fetch (up to 50)
• Stores results in Apify dataset for easy access and processing

Input

The actor accepts the following input parameters:

{
    "rapidApiKey": "YOUR_RAPIDAPI_KEY",
    "zuid": "AGENT_ZUID",
    "maxRecords": 50  // Optional, defaults to 50
}

Parameters

• rapidApiKey (required): Your RapidAPI key for accessing the Zillow API
• zuid (required): The Zillow agent's encoded ZUID
• maxRecords (optional): Maximum number of listings to fetch (1-50, defaults to 50)

Output

The actor outputs an array of active listings, where each listing contains detailed information about the property, including:

• Property details
• Current listing information
• Location data
• Agent information
• Price and status
• And more

Usage

Running Locally

1. Clone this repository
2. Install dependencies:

   $npm install
   

3. Create an input.json file with your configuration
4. Run the actor:

   $apify run
   

Running on Apify

1. Push the actor to your Apify account:

   $apify push
   

2. Configure the input in the Apify Console
3. Run the actor

Rate Limiting

The actor implements rate limiting of 3 requests per second to comply with the RapidAPI Zillow API requirements. This ensures reliable data collection without hitting API limits.

Error Handling

The actor includes comprehensive error handling for:

• API request failures
• Invalid responses
• Rate limit issues
• Network problems

Dependencies

• axios: For making HTTP requests
• apify: For actor functionality
• cheerio: For HTML parsing (if needed)

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support

For support, please open an issue in the repository or contact the maintainer.