📋 Zillow Agent Inventory Scraper

🏢 Introduction

Gain visibility into any real estate agent's current portfolio with the Zillow Agent Inventory Scraper. This utility actor enables you to programmatically fetch all active property listings associated with a specific agent's profile.

Ideal for tracking competitor inventory, analyzing agent performance, or aggregating listings from top performers, this tool parses Zillow agent pages to deliver structured data on every home they currently represent.

Note: Configured for the agentActiveListings data scope.

---

🎯 Key Features

• Portfolio Extraction: Retrieve all active listings for any agent using their unique Zillow ID.
• Detailed Property Metadata: Get essential details for each listing, including price, address, specs (beds/baths), and direct URLs.
• Pagination Support: Iterate through multiple pages of listings to capture complete portfolios for high-volume agents.

---

⚙️ Configuration

To use this actor, you simply need the target agent's identifier and the page you wish to view.

Input Parameters

Parameter	Type	Necessity	Description
zuid	String	Required	The Zillow Agent Profile ID (e.g., X1-ZUytn1phpg9b7t_5i26a).
page_number	Integer	Required	The page number of the agent's listings to scrape (start at 1).

---

📥 Input Example

{
  "zuid": "X1-ZUytn1phpg9b7t_5i26a",
  "page_number": 1
}

---

📤 Sample Output

The output is a structured JSON report of the listings found on the requested page.

{
  "status": "success",
  "page_number": 1,
  "agent_id": "X1-ZUytn1phpg9b7t_5i26a",
  "listings": [
    {
      "listing_id": "20918231",
      "address": "456 Oak St, Seattle, WA 98101",
      "price": 750000,
      "details": {
          "beds": 4,
          "baths": 3,
          "sqft": 2400
      },
      "url": "https://www.zillow.com/homedetails/20918231_zpid/"
    }
  ]
}

---

💡 Best Practices

• Pagination Loops: To get all listings for an agent, start with page_number: 1 and increment the page number in subsequent runs until no results are returned.
• Agent Discovery: Use the ZUIDs found in other Zillow scraping tasks (like property details) to feed this actor and explore related inventory.