# AI Real Estate Lead Generation (`actor4you/ai-real-estate-lead-generation`) Actor Generate real estate leads from Zillow using plain language queries. Describe what you're looking for in natural language and AI will find matching listings with contact information. - **URL**: https://apify.com/actor4you/ai-real-estate-lead-generation.md - **Developed by:** [Actor4you](https://apify.com/actor4you) (community) - **Categories:** Lead generation, AI, Real estate - **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.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/platform/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 ### AI real estate lead generation from Zillow **Generate real estate leads from Zillow using plain English.** Describe the properties you want in natural language - "FSBO listings in 10014 on the market for 30+ days" - and AI translates your query into precise Zillow search filters. Get back structured leads with **listing details**, **pricing data**, and **agent contact information**, ready to import into your CRM. No Zillow API access required. No complex filter configuration. Just tell the Actor what you need and it finds matching properties. ### Features - **Natural language search** - describe leads in plain English instead of configuring dozens of filters - **Full Zillow coverage** - search any US ZIP code for sale, rent, recently sold, foreclosures, FSBO, and new construction - **Agent contact information** - returns agent name, email, phone, broker name, and broker phone for every listing - **Automatic contact enrichment** - finds missing agent details from property pages when the listing data is incomplete - **Choose your AI** - works with Anthropic (Claude) or OpenAI (GPT) for query translation - **Structured output** - clean JSON with 25+ fields per lead, ready for spreadsheets or CRM import - **Runs on Apify cloud** - no local setup, no browser needed, scales to hundreds of listings per run - **Schedule runs** - set up daily or weekly lead generation on autopilot with Apify scheduling ### What data can you extract from Zillow? | Field | Description | Example | |-------|-------------|---------| | address | Full street address | 123 Main St, New York, NY 10014 | | price | Listing price | 1250000 | | zestimate | Zillow's estimated value | 1180000 | | pricePerSqft | Price per square foot | 875 | | daysOnZillow | Days since listed | 45 | | homeType | Property type | SINGLE_FAMILY | | bedrooms | Number of bedrooms | 3 | | bathrooms | Number of bathrooms | 2 | | livingArea | Square footage | 1850 | | lotSize | Lot size in sqft | 5200 | | yearBuilt | Year constructed | 1965 | | agentName | Listing agent name | Jane Smith | | agentEmail | Agent email address | jane@realty.com | | agentPhone | Agent phone number | (212) 555-0142 | | brokerName | Brokerage name | Compass Real Estate | | brokerPhone | Broker phone | (212) 555-0100 | | status | Listing status | FOR_SALE | | lastSoldDate | Previous sale date | 2019-06-15 | | lastSoldPrice | Previous sale price | 980000 | | listingUrl | Direct Zillow link | https://www.zillow.com/... | ### How to generate real estate leads from Zillow 1. **Go to the Actor page** on Apify Store and click **Start**. 2. **Write your search query in plain English.** Include at least one ZIP code. For example: *"For sale by owner listings in zip code 10014 that have been on the market for at least 30 days."* 3. **Enter your AI API key** - either an Anthropic or OpenAI key. The AI translates your natural language query into Zillow search filters. 4. **Set max results** - choose how many listings to return per ZIP code (default: 50, max: 500). 5. **Enable contact enrichment** (on by default) - the Actor fetches missing agent contact details from individual property pages. 6. **Click Run.** The Actor searches Zillow, collects matching listings, enriches contacts, and outputs structured leads. 7. **Export your leads** as JSON, CSV, or Excel. Push them directly to Google Sheets, a webhook, or your real estate CRM via Apify integrations. ### Natural language query examples The AI understands a wide range of real estate search intent. Here are examples of what you can type and what the Actor does with it: **"For sale by owner listings in zip code 10014 that have been on the market for at least 30 days"** Translates to: FSBO filter enabled, days on Zillow = 30+, ZIP = 10014 **"Single family homes in 90210 under $2M with pool"** Translates to: single family only, price max = $2,000,000, pool = yes, ZIP = 90210 **"3+ bedroom condos in 33139 waterfront with AC"** Translates to: bedrooms min = 3, condo type only, waterfront = yes, AC = yes, ZIP = 33139 **"Foreclosures in 07008 under $500k"** Translates to: foreclosure filter enabled, price max = $500,000, ZIP = 07008 **"New construction in 78701 sorted by newest"** Translates to: new construction = yes, sort by newest listings, ZIP = 78701 **"Luxury homes in 94027 and 94301 over $5M with water view"** Translates to: price min = $5,000,000, water view = yes, sort by price high to low, ZIPs = 94027 and 94301 **"Cheap multi-family investment properties in 60616 60617 60619"** Translates to: multi-family type, sort by price low to high, three ZIP codes searched You can combine any number of filters in a single sentence. The AI handles synonyms, abbreviations, and casual phrasing. ### How much does it cost to scrape Zillow? Running this Actor has two cost components: **Apify platform cost:** Approximately **$0.50-$2.00 per run** depending on the number of listings and whether contact enrichment is enabled. A typical run of 50 leads in one ZIP code costs around $0.50-$1.00 in Apify platform credits. Apify's free tier includes $5/month in credits - enough for several runs. **LLM cost:** The AI query translation uses a single API call per run. With Anthropic Claude, this costs roughly $0.01-$0.03. With OpenAI GPT-4o, roughly $0.01-$0.02. This is a one-time cost per run, not per listing. Total cost for a typical 50-lead run: **under $2.00**, including both platform and AI costs. ### Input | Field | Type | Required | Default | Description | |-------|------|----------|---------|-------------| | searchQuery | text | Yes | - | Plain language description of the leads you want. Must include at least one ZIP code. | | maxResults | integer | No | 50 | Maximum listings to return per ZIP code. Range: 1-500. | | enrichContacts | boolean | No | true | Fetch missing agent contact details from property pages. Adds runtime but improves lead completeness. | | llmProvider | select | No | Anthropic | AI provider for query translation. Choose Anthropic (Claude) or OpenAI (GPT). | | llmApiKey | string | Yes | - | Your API key for the selected AI provider. | | llmModel | string | No | auto | AI model to use. Defaults to claude-sonnet-4-20250514 for Anthropic or gpt-4o for OpenAI. | ### Output example Each lead is a JSON object with the following structure: ```json { "listingUrl": "https://www.zillow.com/homedetails/125-W-12th-St-New-York-NY-10014/31522412_zpid/", "address": "125 W 12th St, New York, NY, 10014", "city": "New York", "state": "NY", "zipcode": "10014", "price": 1395000, "zestimate": 1320000, "pricePerSqft": 1046, "daysOnZillow": 47, "status": "FOR_SALE", "homeType": "CONDO", "bedrooms": 2, "bathrooms": 1, "livingArea": 1334, "lotSize": null, "yearBuilt": 1920, "hoaFee": 850, "propertyTax": 12500, "agentName": "Sarah Johnson", "agentEmail": "sarah.johnson@compass.com", "agentPhone": "(212) 555-0178", "brokerName": "Compass", "brokerPhone": "(212) 555-0100", "lastSoldDate": "2018-03-22", "lastSoldPrice": 1050000, "description": "Sun-drenched 2BR in the heart of the West Village...", "mainPhoto": "https://photos.zillowstatic.com/fp/abc123.jpg", "zpid": "31522412" } ```` ### Zillow lead generation use cases #### Real estate agents prospecting FSBO leads Find For Sale By Owner listings that have been sitting on the market. These sellers may be ready to work with an agent. Filter by days on market to target motivated sellers. #### Investors finding undervalued properties Compare listing price vs. Zestimate to spot properties priced below market value. Search for foreclosures, pre-foreclosures, and stale listings across multiple ZIP codes in a single run. #### Market analysis by ZIP code Extract property data across neighborhoods to analyze pricing trends, inventory levels, and days-on-market averages. Export to CSV for spreadsheet analysis. #### Building targeted mailing lists Generate leads with full agent and broker contact information. Export directly to your real estate CRM or email marketing tool for outreach campaigns. #### Competitor property monitoring Track new listings, price changes, and sold properties in your target market. Schedule daily runs to stay ahead of competing agents or investors. #### Finding stale listings for negotiation Search for properties on the market for 90+ days. Sellers with aging inventory are often more open to below-asking offers. ### FAQ #### Is it legal to scrape Zillow listing data? This Actor collects publicly available listing data from Zillow. The data it extracts - addresses, prices, property details, and publicly displayed agent information - is visible to anyone browsing the site. Always review Zillow's Terms of Service and comply with applicable laws in your jurisdiction. Use the data responsibly. #### How accurate is the natural language search? The AI query translation is powered by Claude or GPT-4o, which understand real estate terminology, abbreviations (FSBO, sqft, HOA), and casual phrasing with high accuracy. The Actor stores the interpreted search parameters in the Key-Value Store so you can verify exactly how your query was translated. If results don't match expectations, try rephrasing with more specific terms. #### Do I need my own AI API key? Yes. You need either an Anthropic API key or an OpenAI API key. The Actor uses one AI call per run to translate your natural language query into Zillow search filters. This typically costs $0.01-$0.03 per run. You can get an API key from [Anthropic](https://console.anthropic.com/) or [OpenAI](https://platform.openai.com/). #### Can I enrich leads with additional contact information? Yes. The **Enrich Missing Contact Info** option is enabled by default. When a listing is missing agent details (name, email, or phone), the Actor visits the individual property page to extract contact information. This adds some runtime but significantly improves lead completeness - especially for FSBO and newer listings where contact data may not appear in search results. #### Is this a Zillow API alternative? Yes. Zillow's official API (the Zestimate API and Property Data API) has been largely deprecated or restricted. This Actor provides a **Zillow API alternative** that returns richer data - including agent contact information, property descriptions, and pricing history - without needing API access or approval. It works through Zillow's public search interface, powered by Apify's web scraping infrastructure. # Actor input Schema ## `searchQuery` (type: `string`): Describe what leads you want in plain language. Must include at least one ZIP code. Examples: 'FSBO listings in 10014 on the market for 30+ days', 'Single family homes in 90210 under $2M with pool', '3+ bed homes in 07008 listed by owner, at least 2000 sqft'. ## `maxResults` (type: `integer`): Maximum number of listings to return per ZIP code. Higher values increase runtime. ## `enrichContacts` (type: `boolean`): Try to find contact details for listings where agent info is missing. Adds extra runtime but provides more complete leads. ## `llmProvider` (type: `string`): Which AI provider to use for query translation. ## `llmApiKey` (type: `string`): Your API key for the selected AI provider (Anthropic or OpenAI). ## `llmModel` (type: `string`): Model to use. Leave empty for defaults: claude-sonnet-4-20250514 (Anthropic) or gpt-4o (OpenAI). ## Actor input object example ```json { "searchQuery": "For sale by owner listings in zip code 10014 that have been on the market for at least 30 days", "maxResults": 50, "enrichContacts": true, "llmProvider": "anthropic" } ``` # 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 = { "searchQuery": "For sale by owner listings in zip code 10014 that have been on the market for at least 30 days" }; // Run the Actor and wait for it to finish const run = await client.actor("actor4you/ai-real-estate-lead-generation").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 = { "searchQuery": "For sale by owner listings in zip code 10014 that have been on the market for at least 30 days" } # Run the Actor and wait for it to finish run = client.actor("actor4you/ai-real-estate-lead-generation").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 '{ "searchQuery": "For sale by owner listings in zip code 10014 that have been on the market for at least 30 days" }' | apify call actor4you/ai-real-estate-lead-generation --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=actor4you/ai-real-estate-lead-generation", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "AI Real Estate Lead Generation", "description": "Generate real estate leads from Zillow using plain language queries. Describe what you're looking for in natural language and AI will find matching listings with contact information.", "version": "0.0", "x-build-id": "K8nz5bzgB4TycEPxU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/actor4you~ai-real-estate-lead-generation/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-actor4you-ai-real-estate-lead-generation", "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/actor4you~ai-real-estate-lead-generation/runs": { "post": { "operationId": "runs-sync-actor4you-ai-real-estate-lead-generation", "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/actor4you~ai-real-estate-lead-generation/run-sync": { "post": { "operationId": "run-sync-actor4you-ai-real-estate-lead-generation", "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": [ "searchQuery", "llmApiKey" ], "properties": { "searchQuery": { "title": "Search Query", "type": "string", "description": "Describe what leads you want in plain language. Must include at least one ZIP code. Examples: 'FSBO listings in 10014 on the market for 30+ days', 'Single family homes in 90210 under $2M with pool', '3+ bed homes in 07008 listed by owner, at least 2000 sqft'." }, "maxResults": { "title": "Max Results Per ZIP Code", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum number of listings to return per ZIP code. Higher values increase runtime.", "default": 50 }, "enrichContacts": { "title": "Enrich Missing Contact Info", "type": "boolean", "description": "Try to find contact details for listings where agent info is missing. Adds extra runtime but provides more complete leads.", "default": true }, "llmProvider": { "title": "AI Provider", "enum": [ "anthropic", "openai" ], "type": "string", "description": "Which AI provider to use for query translation.", "default": "anthropic" }, "llmApiKey": { "title": "AI API Key", "type": "string", "description": "Your API key for the selected AI provider (Anthropic or OpenAI)." }, "llmModel": { "title": "AI Model", "type": "string", "description": "Model to use. Leave empty for defaults: claude-sonnet-4-20250514 (Anthropic) or gpt-4o (OpenAI)." } } }, "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 } } } } } } } } } } ```