Zillow Agent Sold Listings Scraper This Apify actor fetches sold 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 sold 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: json { "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 sold listings, where each listing contains detailed information about the property, including: - Property details - Sale information - Location data - Agent information - And more ## Usage ### Running Locally 1. Clone this repository 2. Install dependencies: bash npm install 3. Create an input.json file with your configuration 4. Run the actor: bash apify run ### Running on Apify 1. Push the actor to your Apify account: bash 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.