# Zillow Agents Scraper - Low-cost๐Ÿ’ฒ๐Ÿ”ฅ๐Ÿก๐Ÿ“ง (`delectable_incubator/zillow-agents-scraper-low-cost`) Actor ๐Ÿก Easily scrape Zillow professional profiles. Extract real estate agents, property managers, inspectors, photographers, home improvement pros, ratings, reviews, contact details, service areas, profile URLs & more. Perfect for lead generation, market research & real estate intelligence - **URL**: https://apify.com/delectable\_incubator/zillow-agents-scraper-low-cost.md - **Developed by:** [Prime Scrape](https://apify.com/delectable_incubator) (community) - **Categories:** Jobs, Automation, Lead generation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $0.00005 / actor start This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README

Zillow Professionals Finder Scraper

--- ## ๐Ÿก๐Ÿ” Zillow Professionals Finder Scraper | All-in-One | Bulk Cities | Apify Actor ### ๐Ÿš€ Extract Zillow Real Estate Professionals Data at Scale The **Zillow Professionals Finder Scraper (All-in-One)** is a powerful and scalable Apify Actor designed to extract structured professional profiles from **Zillow**. It allows you to search and scrape professionals across **multiple cities or ZIP codes in a single run**, automatically handle pagination, filter professionals by **specialty and preferred language**, and collect detailed business, contact, profile, review, and sales information. Perfect for: ๐Ÿก Real estate lead generation ๐Ÿ“ž Real estate agent prospecting ๐Ÿข Property management research ๐Ÿ› ๏ธ Home improvement professionals ๐Ÿ” Home inspector research ๐Ÿ“ธ Real estate photographer discovery ๐Ÿ“Š Real estate market intelligence ๐ŸŽฏ Lead generation campaigns ๐Ÿ’ผ CRM enrichment ๐Ÿ“ˆ Real estate business analysis --- ### ๐Ÿ”ฅ Why Use This Zillow Professionals Scraper? โœ” **Bulk city scraping** โ€” search multiple cities or ZIP codes in one run โœ” Automatic pagination for each city โœ” Control the maximum number of professionals per city โœ” Filter by professional specialty โœ” Filter by preferred spoken language โœ” Extract real estate agents and property managers โœ” Search home improvement professionals โœ” Collect detailed agent and business profiles โœ” Extract phone numbers when available โœ” Extract Zillow profile links โœ” Extract profile photos โœ” Extract review summaries and ratings โœ” Extract recent review excerpts โœ” Extract review dates and links โœ” Extract lifetime sales statistics โœ” Extract last-year sales statistics โœ” Extract three-year sale price ranges โœ” Identify team leads โœ” Identify top agents โœ” Residential US proxy support โœ” Clean, structured, analysis-ready datasets โœ” Multiple export formats supported โœ” No coding required --- ### ๐ŸŽฏ What This Scraper Does Simply provide **one or more cities or ZIP codes**, select your desired **specialty**, choose a **preferred language**, and define the maximum number of professionals to extract per city. The Actor will automatically: 1. ๐Ÿ” Search Zillow professionals for each city 2. ๐Ÿ“„ Navigate through paginated search results 3. ๐Ÿก Apply the selected specialty filter 4. ๐Ÿ—ฃ๏ธ Apply the preferred language filter 5. ๐Ÿ“Š Extract detailed professional information 6. ๐Ÿ”„ Continue pagination until the city limit is reached 7. ๐Ÿ’พ Store all results in an Apify Dataset Each city is processed as its own paginated Zillow search. --- ## ๐ŸŒ BULK CITY MODE ๐Ÿš€ The main advantage of this version is the ability to scrape **multiple cities or ZIP codes in a single run**. #### Example: ```` { "cities": \[ "New York, NY", "Los Angeles, CA", "Miami, FL", "Houston, TX", "Dallas, TX", "Chicago, IL" ], "speciality": "Any (Real Estate Agent / Property Manager) ๐Ÿก", "language": "English", "maxItemsPerCity": 50 } ``` The scraper will automatically process each city independently. For example: ``` New York, NY โ†’ Up to 50 professionals Los Angeles, CA โ†’ Up to 50 professionals Miami, FL โ†’ Up to 50 professionals Houston, TX โ†’ Up to 50 professionals Dallas, TX โ†’ Up to 50 professionals Chicago, IL โ†’ Up to 50 professionals ``` This makes it easy to build large-scale datasets covering multiple real estate markets. --- ### ๐Ÿ™๏ธ Supported City & ZIP Code Search You can enter one or multiple cities, locations, or ZIP codes. Examples: ``` New York, NY Los Angeles, CA Miami, FL Houston, TX Dallas, TX Chicago, IL Austin, TX San Diego, CA 10001 90210 33101 ``` Each location is scraped independently with automatic pagination. --- ### ๐ŸŽฏ Specialty Filtering The scraper supports multiple Zillow professional specialties. #### ๐Ÿก Real Estate & Property Management Available specialties include: * Any (Real Estate Agent / Property Manager) ๐Ÿก * First Time Homebuyers ๐Ÿก * Investment Properties ๐Ÿก * Rentals ๐Ÿก * Military/Veterans ๐Ÿก * Luxury Homes ๐Ÿก * New Construction ๐Ÿก * Property Management ๐Ÿก * Senior Communities ๐Ÿก * Relocation ๐Ÿก * Foreclosure ๐Ÿก * Lot/Land ๐Ÿก * Vacation / Short-term Rentals ๐Ÿก #### ๐Ÿ› ๏ธ Home Improvement Professionals * Any (Home Improvements) ๐Ÿ› ๏ธ Depending on the selected specialty, the Actor automatically routes the search to the appropriate Zillow professional results or review pages. --- ### ๐Ÿ—ฃ๏ธ Language Filtering You can select the preferred spoken language of professionals. Supported languages include: ๐Ÿ‡บ๐Ÿ‡ธ English ๐Ÿ‡ธ๐Ÿ‡ฆ Arabic ๐Ÿ‡ง๐Ÿ‡ฉ Bengali ๐Ÿ‡ญ๐Ÿ‡ฐ Cantonese ๐Ÿ‡ฎ๐Ÿ‡ท Farsi ๐Ÿ‡ซ๐Ÿ‡ท French ๐Ÿ‡ฉ๐Ÿ‡ช German ๐Ÿ‡ฌ๐Ÿ‡ท Greek ๐Ÿ‡ฎ๐Ÿ‡ฑ Hebrew ๐Ÿ‡ฎ๐Ÿ‡ณ Hindi ๐Ÿ‡ญ๐Ÿ‡บ Hungarian ๐Ÿ‡ฎ๐Ÿ‡น Italian ๐Ÿ‡ฏ๐Ÿ‡ต Japanese ๐Ÿ‡ฐ๐Ÿ‡ท Korean ๐Ÿ‡จ๐Ÿ‡ณ Mandarin ๐Ÿ‡ต๐Ÿ‡ฑ Polish ๐Ÿ‡ต๐Ÿ‡น Portuguese ๐Ÿ‡ท๐Ÿ‡บ Russian ๐Ÿ‡ช๐Ÿ‡ธ Spanish ๐Ÿ‡ต๐Ÿ‡ญ Tagalog (Filipino) ๐Ÿ‡น๐Ÿ‡ญ Thai ๐Ÿ‡น๐Ÿ‡ท Turkish ๐Ÿ‡ป๐Ÿ‡ณ Vietnamese This makes the scraper particularly useful for multilingual real estate lead generation and local market research. --- ### ๐Ÿ“Š Extracted Professional Data The Zillow Professionals Finder extracts structured information such as: | Field | Description | | ---------------------------- | --------------------------------------------------------------- | | `id` | Unique extracted professional ID | | `businessName` | Business or team name | | `fullName` | Professional's full name | | `phoneNumber` | Contact phone number when available | | `location` | Professional location | | `profileLink` | Zillow professional profile URL | | `profilePhotoSrc` | Professional profile photo URL | | `reviewExcerpt` | Recent review excerpt | | `reviewExcerptDate` | Date of the extracted review | | `reviewLink` | Direct Zillow reviews URL | | `numTotalReviews` | Total number of reviews | | `reviews` | Formatted review count | | `reviewStarsRating` | Average star rating | | `saleCountAllTime` | Total sales count | | `saleCountLastYear` | Sales count during the last year | | `salePriceRangeThreeYearMin` | Minimum sale price over three years | | `salePriceRangeThreeYearMax` | Maximum sale price over three years | | `isTeamLead` | Indicates whether the professional is a team lead | | `isTopAgent` | Indicates whether the professional is identified as a top agent | --- ### โšก Input Configuration #### ๐Ÿ“ฅ Full Input Example ``` { "cities": \[ "New York, NY", "Los Angeles, CA", "Miami, FL" ], "speciality": "Luxury Homes ๐Ÿก", "language": "English", "maxItemsPerCity": 50, "proxy": { "useApifyProxy": true, "apifyProxyGroups": \[ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ``` --- ### ๐Ÿงฉ Input Fields | Field | Type | Required | Description | | ----------------- | ------- | -------- | ----------------------------------------- | | `cities` | array | โœ… Yes | One or more cities or ZIP codes to search | | `speciality` | string | โŒ No | Zillow professional specialty filter | | `language` | string | โŒ No | Preferred spoken language | | `maxItemsPerCity` | integer | โŒ No | Maximum professionals to extract per city | | `proxy` | object | โŒ No | Apify residential proxy configuration | --- ### ๐Ÿ™๏ธ Cities Input The `cities` field accepts multiple locations. Example: ``` { "cities": \[ "Texas City, TX", "Houston, TX", "Dallas, TX", "Austin, TX" ] } ``` Each city is processed independently. The scraper automatically paginates through Zillow search results until: * The `maxItemsPerCity` limit is reached * No more professionals are available * The search results are exhausted --- ### ๐Ÿ”ข Maximum Professionals Per City Use `maxItemsPerCity` to control how many professionals are extracted for each location. Example: ``` { "cities": \[ "New York, NY", "Miami, FL" ], "maxItemsPerCity": 100 } ``` Expected maximum: ``` New York, NY โ†’ Up to 100 professionals Miami, FL โ†’ Up to 100 professionals ``` The limit is applied **per city**, making it easy to scale your data collection across multiple markets. --- ### ๐Ÿ› ๏ธ How to Use the Scraper #### 1๏ธโƒฃ Deploy the Actor on Apify Open the Zillow Professionals Finder Scraper and launch a new run. #### 2๏ธโƒฃ Add Your Cities Enter one or multiple cities or ZIP codes. Example: ``` New York, NY Miami, FL Los Angeles, CA Chicago, IL Houston, TX ``` #### 3๏ธโƒฃ Select a Specialty Choose from available Zillow professional specialties. Example: ``` Luxury Homes ๐Ÿก ``` #### 4๏ธโƒฃ Select a Preferred Language Choose the language spoken by the professionals you want to find. Example: ``` Spanish ``` #### 5๏ธโƒฃ Set Maximum Professionals Per City Example: ``` 50 ``` The scraper will collect up to 50 professionals for each city. #### 6๏ธโƒฃ Configure Residential Proxy The scraper is configured to use a **US residential proxy** through Apify Proxy. Recommended configuration: ``` { "useApifyProxy": true, "apifyProxyGroups": \[ "RESIDENTIAL" ], "apifyProxyCountry": "US" } ``` #### 7๏ธโƒฃ Run the Scraper Start the Actor. The scraper will automatically: * Search each city * Apply the selected filters * Navigate through pagination * Extract professional profiles * Store the results in the dataset #### 8๏ธโƒฃ Export Your Data Export your results in formats supported by Apify, including: โœ… JSON โœ… CSV โœ… Excel โœ… XML โœ… RSS โœ… HTML Table --- ### ๐Ÿ“ฆ Example Output ``` { "id": 1, "businessName": "Whittington Realty", "fullName": "Whittington Realty", "phoneNumber": "(405) 247-0346", "location": "Oklahoma City, OK", "profileLink": "https://www.zillow.com/profile/Whittington-Realty", "profilePhotoSrc": "https://photos.zillowstatic.com/fp/d5f1d446f5679c5ac7b9322703eff172-h\_g.jpg", "reviewExcerpt": "Helping buy my first home she eloquently walked me through the process ...", "reviewExcerptDate": "2024-10-05 09:04:00", "reviewLink": "https://www.zillow.com/profile/Whittington-Realty#reviews", "numTotalReviews": 588, "reviews": "588 reviews", "reviewStarsRating": 5, "saleCountAllTime": 3704, "saleCountLastYear": 263, "salePriceRangeThreeYearMin": 15000, "salePriceRangeThreeYearMax": 1829520, "isTeamLead": true, "isTopAgent": true } ```` --- ### ๐Ÿ“Š Built-in Dataset Views #### ๐Ÿ“‹ Overview View Quick overview of Zillow professional profiles. Includes: * Business Name * Full Name * Phone Number * Location * Profile Link * Review Rating * Total Reviews #### โญ Reviews & Ratings View Analyze professional reputation. Includes: * Full Name * Business Name * Total Reviews * Star Rating * Review Excerpt * Review Date * Review Link #### ๐Ÿ“ˆ Sales Statistics View Analyze professional sales performance. Includes: * Business Name * Full Name * All-Time Sales * Last-Year Sales * Three-Year Minimum Sale Price * Three-Year Maximum Sale Price #### ๐Ÿ† Top Professionals View Identify high-performing professionals. Includes: * Full Name * Business Name * Location * Is Team Lead * Is Top Agent * Review Rating * Sales Statistics #### ๐Ÿ“ž Lead Generation View Build a structured real estate prospecting dataset. Includes: * Business Name * Full Name * Phone Number * Location * Profile Link * Profile Photo * Review Rating * Sales Statistics --- ### ๐Ÿ’ก Use Cases #### ๐Ÿก Real Estate Lead Generation Find real estate agents and professionals across multiple cities and markets. #### ๐Ÿ“ž Agent Prospecting Build targeted lists of professionals based on location, specialty, and language. #### ๐ŸŽฏ Multilingual Lead Generation Find professionals who speak specific languages for local and international real estate campaigns. #### ๐Ÿข Property Management Research Identify property managers and professionals specializing in rental and property management services. #### ๐Ÿ’Ž Luxury Real Estate Intelligence Find professionals specializing in luxury homes and high-value properties. #### ๐Ÿ—๏ธ New Construction Research Identify professionals focused on new construction properties. #### ๐ŸŒŽ Relocation Services Find agents specializing in relocation and specific client communities. #### ๐Ÿ› ๏ธ Home Improvement Market Research Discover professionals operating in the home improvement ecosystem. #### ๐Ÿ“Š Real Estate Market Intelligence Analyze professional coverage, reviews, sales activity, and market presence across multiple locations. #### ๐Ÿ’ผ CRM Enrichment Use structured professional data to enrich internal CRM systems and business intelligence workflows. --- ### ๐Ÿš€ Key Features ๐Ÿ™๏ธ **Bulk City Scraping** Scrape multiple cities or ZIP codes in a single run. ๐Ÿ“„ **Automatic Pagination** Automatically navigate Zillow results until the desired limit is reached. ๐ŸŽฏ **Specialty Filtering** Target specific real estate and professional specialties. ๐Ÿ—ฃ๏ธ **Language Filtering** Find professionals based on preferred spoken language. ๐Ÿ“ž **Contact Data** Extract phone numbers when available. โญ **Review Intelligence** Collect review counts, ratings, excerpts, dates, and review links. ๐Ÿ“ˆ **Sales Statistics** Extract all-time sales, last-year sales, and three-year price ranges. ๐Ÿ† **Top Agent Detection** Identify top agents and team leads. ๐Ÿก **Real Estate Intelligence** Build structured datasets for real estate research and lead generation. โš™๏ธ **Scalable Apify Execution** Run large-scale searches in the cloud. ๐Ÿ” **Residential Proxy Support** Designed to work with US residential proxies. ๐Ÿ“Š **Export-Ready Data** Use your results in JSON, CSV, Excel, XML, RSS, or HTML Table formats. --- ### ๐Ÿ”ฅ Why This is a Powerful Zillow Professionals Scraper โœ” Scrape multiple cities in one run โœ” Collect up to a custom number of professionals per city โœ” Automatically paginate through Zillow results โœ” Search by ZIP code or city โœ” Filter by specialty โœ” Filter by preferred language โœ” Extract phone numbers โœ” Extract business and professional names โœ” Extract Zillow profile URLs โœ” Extract profile photos โœ” Extract review information โœ” Extract ratings โœ” Extract sales statistics โœ” Identify top agents โœ” Identify team leads โœ” Build targeted real estate lead lists โœ” No coding required --- ### ๐Ÿ’ธ Pricing This scraper runs on a **pay-per-result pricing model**. You only pay for successfully extracted records. ๐Ÿ’ณ **Price:** **$1.49 / 1,000 results** --- ### โ“ FAQ #### Can I scrape multiple cities at once? Yes. The scraper supports **Bulk City Scraping**, allowing you to provide multiple cities or ZIP codes in the `cities` array. #### Can I scrape multiple ZIP codes? Yes. ZIP codes can be provided in the `cities` input field. #### Can I limit results per city? Yes. Use `maxItemsPerCity` to define the maximum number of professionals to collect for each city. #### Does the scraper automatically paginate? Yes. The Actor automatically navigates through paginated Zillow search results until the configured city limit is reached or no more results are available. #### Can I filter professionals by specialty? Yes. The scraper supports Zillow specialty filters including luxury homes, investment properties, rentals, relocation, property management, new construction, foreclosure, lot/land, and more. #### Can I filter by language? Yes. You can select from multiple supported languages, including English, Spanish, French, Arabic, Mandarin, Russian, Portuguese, and others. #### Can I find property managers? Yes. The scraper supports Property Management and real estate/property management professional searches. #### Can I find luxury real estate agents? Yes. Select the **Luxury Homes ๐Ÿก** specialty. #### Can I extract phone numbers? Yes. Phone numbers are extracted when available in the professional profile data. #### Can I extract sales statistics? Yes. Available sales information includes all-time sales, last-year sales, and three-year sale price ranges. #### Can I identify top agents? Yes. The output includes `isTopAgent` and `isTeamLead` indicators when available. #### Do I need a residential proxy? The recommended configuration uses an Apify **US Residential Proxy** to improve reliability when accessing Zillow. #### Can I export the results? Yes. Apify datasets can be exported to JSON, CSV, Excel, XML, RSS, and HTML Table formats. --- ### ๐Ÿ”— Related Actors If you're interested in other real estate, property, professional, and market intelligence scraping solutions, check out these related tools: --- ### ๐ŸŒ PrimeScrape Data Intelligence Ecosystem The **PrimeScrape Data Intelligence Suite** is designed for scalable data extraction, lead generation, business intelligence, market research, and automation. ๐Ÿก Real estate data extraction ๐Ÿข Property management intelligence ๐Ÿ“ž Professional lead generation ๐ŸŽฏ Business lead enrichment ๐Ÿ“Š Market intelligence ๐Ÿ“ˆ Sales performance analysis โญ Review intelligence ๐Ÿค– AI-ready datasets โš™๏ธ Automation pipelines ๐ŸŒ Large-scale web data extraction --- ### โš ๏ธ Disclaimer This scraper is an independent automation and data extraction tool. It is **not affiliated with, endorsed by, or sponsored by Zillow**. Users are responsible for ensuring that their use of this scraper complies with applicable laws, regulations, and the terms of service of the websites they access. --- ### ๐Ÿ“ฌ Support โญโญโญโญโญ Leave a 5-star review if you are satisfied with this scraper. ๐Ÿ“ฉ For questions, feature requests, custom scraping solutions, or enterprise projects, contact us through the Apify platform. ๐Ÿš€ **PrimeScrape โ€” Data Extraction & Automation at Scale.** # Actor input Schema ## `cities` (type: `array`): One or more cities or zip codes, e.g. "Texas City, TX". Each will be scraped as its own paginated search. ## `speciality` (type: `string`): Real Estate Agent and Property Manager specialties are filtered directly via Zillow's specialties= parameter. Home Improvement / Home Inspector / Photographer just route to their own review pages (no sub-filter, same as before). ## `language` (type: `string`): The spoken language you prefer ## `maxItemsPerCity` (type: `integer`): Maximum number of professionals to extract per city (auto-paginates) ## `proxy` (type: `object`): RESIDENTIAL proxy required ## Actor input object example ```json { "cities": [ "Texas City, TX" ], "speciality": "Any (Real Estate Agent / Property Manager) ๐Ÿก", "language": "English", "maxItemsPerCity": 30, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ```` # Actor output Schema ## `overview` (type: `string`): No description # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "cities": [ "Texas City, TX" ], "speciality": "Any (Real Estate Agent / Property Manager) ๐Ÿก", "language": "English", "maxItemsPerCity": 30, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("delectable_incubator/zillow-agents-scraper-low-cost").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "cities": ["Texas City, TX"], "speciality": "Any (Real Estate Agent / Property Manager) ๐Ÿก", "language": "English", "maxItemsPerCity": 30, "proxy": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", }, } # Run the Actor and wait for it to finish run = client.actor("delectable_incubator/zillow-agents-scraper-low-cost").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "cities": [ "Texas City, TX" ], "speciality": "Any (Real Estate Agent / Property Manager) ๐Ÿก", "language": "English", "maxItemsPerCity": 30, "proxy": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call delectable_incubator/zillow-agents-scraper-low-cost --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=delectable_incubator/zillow-agents-scraper-low-cost", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Zillow Agents Scraper - Low-cost๐Ÿ’ฒ๐Ÿ”ฅ๐Ÿก๐Ÿ“ง", "description": "๐Ÿก Easily scrape Zillow professional profiles. Extract real estate agents, property managers, inspectors, photographers, home improvement pros, ratings, reviews, contact details, service areas, profile URLs & more. Perfect for lead generation, market research & real estate intelligence", "version": "0.0", "x-build-id": "XPrKIkU8A0KZv1WhA" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/delectable_incubator~zillow-agents-scraper-low-cost/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-delectable_incubator-zillow-agents-scraper-low-cost", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/delectable_incubator~zillow-agents-scraper-low-cost/runs": { "post": { "operationId": "runs-sync-delectable_incubator-zillow-agents-scraper-low-cost", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/delectable_incubator~zillow-agents-scraper-low-cost/run-sync": { "post": { "operationId": "run-sync-delectable_incubator-zillow-agents-scraper-low-cost", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "cities" ], "properties": { "cities": { "title": "Cities (Required) ๐Ÿ™๏ธ", "type": "array", "description": "One or more cities or zip codes, e.g. \"Texas City, TX\". Each will be scraped as its own paginated search.", "default": [ "Texas City, TX" ], "items": { "type": "string" } }, "speciality": { "title": "Choose a Specialty", "enum": [ "Any (Real Estate Agent / Property Manager) ๐Ÿก", "First Time Homebuyers ๐Ÿก", "Investment Properties ๐Ÿก", "Rentals ๐Ÿก", "Military/Veterans ๐Ÿก", "Luxury Homes ๐Ÿก", "New Construction ๐Ÿก", "Property Management ๐Ÿก", "Senior Communities ๐Ÿก", "Relocation ๐Ÿก", "Foreclosure ๐Ÿก", "Lot/Land ๐Ÿก", "Vacation / Short-term Rentals ๐Ÿก", "Any (Home Improvements) ๐Ÿ› ๏ธ" ], "type": "string", "description": "Real Estate Agent and Property Manager specialties are filtered directly via Zillow's specialties= parameter. Home Improvement / Home Inspector / Photographer just route to their own review pages (no sub-filter, same as before).", "default": "Any (Real Estate Agent / Property Manager) ๐Ÿก" }, "language": { "title": "Language you prefer", "enum": [ "English", "Arabic", "Bengali", "Cantonese", "Farsi", "French", "German", "Greek", "Hebrew", "Hindi", "Hungarian", "Italian", "Japanese", "Korean", "Mandarin", "Polish", "Portuguese", "Russian", "Spanish", "Tagalog (Filipino)", "Thai", "Turkish", "Vietnamese" ], "type": "string", "description": "The spoken language you prefer", "default": "English" }, "maxItemsPerCity": { "title": "Max professionals per city ๐Ÿ”ข", "type": "integer", "description": "Maximum number of professionals to extract per city (auto-paginates)", "default": 30 }, "proxy": { "title": "Proxy Configuration", "type": "object", "description": "RESIDENTIAL proxy required", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```