🔎 Zillow Agent Finder

🗺️ Introduction

Discover and connect with top real estate professionals using the Zillow Agent Finder. This actor acts as a powerful search engine for the Zillow directory, allowing you to locate agents by name and refine your results by geographic location.

Whether you are building a recruitment pipeline, searching for a specific realtor, or analyzing market coverage, this tool delivers matching profiles with speed and accuracy.

Note: Configured for the agentSearch data scope.

---

🚀 Key Features

• Targeted Search: Find agents by their full name or partial matches.
• Location Filtering: Drill down into specific cities or markets to find local experts.
• Profile Discovery: Retrieve essential preview data including brokerage affiliation, rating summaries, and profile URLs.

---

⚙️ Configuration

Start your search with just a name. Add a location to narrow down the results effectively.

Input Parameters

Parameter	Type	Necessity	Description
name	String	Required	The name of the agent to search for.
location	String	Optional	The city or region filter (e.g., "New York").
page_number	Integer	Required	The page of search results to retrieve (start at 1).

---

📥 Input Example

{
  "name": "Sarah Jones",
  "location": "Dallas, TX",
  "page_number": 1
}

---

📤 Sample Output

The output lists all agents matching your search criteria.

{
  "status": "success",
  "page_number": 1,
  "results": [
    {
      "agent_name": "Sarah Jones",
      "brokerage": "Lone Star Realty",
      "location": "Dallas, TX",
      "reviews": 12,
      "rating": 4.8,
      "url": "https://www.zillow.com/profile/sarahjonesrealtor/"
    }
  ]
}

---

💡 Best Practices

• Precision Searching: If a common name yields too many results, always use the location parameter to filter by the specific market of interest.
• Lead Generation: Use this actor to find agents in a target area and then use the Zillow Agent Details actor to enrich their profiles with contact info.