{ "openapi": "3.0.1", "info": { "title": "US Real Estate Agents Scraper: Zillow, Realtor, Homes.com", "description": "Find US real estate agents on Zillow, Realtor.com and Homes.com by city, ZIP code, state or name: phones, email, license, brokerage, sales, reviews. Live search or instant database. Export to JSON, CSV or Excel.", "version": "0.0", "x-build-id": "zWBDGCsdh8M1Am2oT" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nice_dev~us-real-estate-agents/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nice_dev-us-real-estate-agents", "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/nice_dev~us-real-estate-agents/runs": { "post": { "operationId": "runs-sync-nice_dev-us-real-estate-agents", "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/nice_dev~us-real-estate-agents/run-sync": { "post": { "operationId": "run-sync-nice_dev-us-real-estate-agents", "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", "properties": { "mode": { "title": "Data source", "enum": [ "live", "database" ], "type": "string", "description": "`live` reads Zillow, Realtor.com and Homes.com now (fresh data, capped by the sites: 375 agents per Zillow search, about 9 600 per Realtor.com search, 624 per Homes.com search — larger areas are covered automatically). `database` answers instantly from our pre-collected agent database, which currently holds Realtor.com agents (no site cap, filters on contact, sales and freshness).", "default": "live" }, "sites": { "title": "Sites", "uniqueItems": true, "type": "array", "description": "Sites to read in live mode (empty = all). In database mode, the sites an agent must come from: the database currently holds Realtor.com agents only, so a choice without Realtor.com returns no agent. Homes.com gives agent cards (name, brokerage, phone, sales); its profile page (email, license) is not read.", "items": { "type": "string", "enum": [ "zillow", "realtor", "homes" ], "enumTitles": [ "Zillow", "Realtor.com", "Homes.com" ] }, "default": [ "zillow", "realtor", "homes" ] }, "startUrls": { "title": "Start URLs", "maxItems": 1000, "type": "array", "description": "Zillow agent directory URLs (`https://www.zillow.com/professionals/real-estate-agent-reviews/austin-tx/?isTopAgent=true`, filters kept) or profile URLs (`https://www.zillow.com/profile/`), Realtor.com agent directory URLs (`https://www.realtor.com/realestateagents/austin_tx`) or profile URLs (`https://www.realtor.com/realestateagents/`, with the short agent number), Homes.com agent directory URLs (`https://www.homes.com/real-estate-agents/austin-tx/`; a Homes.com profile page is not read). When this list is not empty, the location and name fields below are ignored; the filters are applied by the Actor to each agent read, and caps and monitoring still apply. Live mode only. Max 1 000 URLs.", "default": [], "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "location": { "title": "Location", "maxLength": 200, "type": "string", "description": "City and state (`Austin, TX`), ZIP code (`78704`), county (`Travis County, TX`) or state (`TX` or `Texas`). In live mode a county or a state is searched Zillow: city by city; Realtor.com and Homes.com: ZIP code by ZIP code (a state is a long run: set Max agents). In database mode the same values filter the database." }, "locations": { "title": "More locations", "maxItems": 500, "uniqueItems": true, "type": "array", "description": "Several locations in one run (cities, ZIP codes, states), each searched on its own; added to **Location**. Agents found by several searches are saved once. Max 500 searches per run.", "default": [], "items": { "type": "string" } }, "radiusMiles": { "title": "Radius around the location (miles)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Also search every ZIP code whose center is within this distance of each city or ZIP code location (live mode: Zillow city by city, Realtor.com and Homes.com ZIP code by ZIP code), or keep database agents whose office is within it. 0 = the location itself only.", "default": 0 }, "agentName": { "title": "Agent name", "maxLength": 200, "type": "string", "description": "Agent or team name, full or partial (`smith`). Realtor.com searches it nationwide when no location is set; Zillow needs a location; Homes.com returns at most 10 agents from the whole country (the location is not applied there, the filters are)." }, "agentIds": { "title": "Agent IDs (lookup)", "maxItems": 1000, "uniqueItems": true, "type": "array", "description": "Look up known agents directly: Realtor.com fulfillment IDs (digits, `1918615`) or Zillow screen names (`ericbramlett`). A Zillow encoded ID (X1-ZU…) cannot be opened: give the profile URL or the screen name. A screen name of 7 lowercase letters or digits is taken for a Homes.com key and refused: paste its profile URL in **Start URLs** instead. Other search fields are ignored for these; the filters are applied by the Actor to each agent. Max 1 000.", "default": [], "items": { "type": "string" } }, "maxItems": { "title": "Max agents", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Maximum number of agents to save for the whole run (after deduplication and filters). 0 = no limit.", "default": 100 }, "maxItemsPerQuery": { "title": "Max agents per search", "minimum": 0, "maximum": 1000000, "type": "integer", "description": "Cap for EACH search (location, name or start URL), so that the first search cannot use up the whole **Max agents** budget. 0 = no per-search cap. Live mode only: the database mode ranks every location together, **Max agents** caps it.", "default": 0 }, "extractDetails": { "title": "Full profile (phone, email, license)", "type": "boolean", "description": "Open each agent's profile (extra requests per agent in live mode: 1 on Zillow, 3 on Realtor.com): cell and office phones, email, licenses with state and expiry, MLS IDs, website and social links, bio, languages, specialties, service areas, years of experience. Off = directory-card fields only (name, brokerage, rating, sales counts, price range). Database rows always carry the full profile.", "default": true }, "includeReviews": { "title": "Add client reviews (paid option)", "type": "boolean", "description": "Add the agent's latest client reviews (text, rating, date, sub-ratings, agent reply). Needs **Full profile**. Charged per agent that has reviews (see Pricing).", "default": false }, "maxReviewsPerAgent": { "title": "Max reviews per agent", "minimum": 1, "maximum": 500, "type": "integer", "description": "Reviews kept per agent when **Add client reviews** is on. A Zillow profile shows about 10 reviews: the higher caps apply to Realtor.com.", "default": 20 }, "includePastSales": { "title": "Add past sales (paid option)", "type": "boolean", "description": "Add the agent's closed deals (address, price, date, buyer or seller side, coordinates). Needs **Full profile**. Charged per agent that has past sales (see Pricing).", "default": false }, "maxSoldPerAgent": { "title": "Max past sales per agent", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Past sales kept per agent when **Add past sales** is on. A Zillow profile shows about 5 past sales: the higher caps apply to Realtor.com.", "default": 50 }, "includeListings": { "title": "Add active listings (paid option)", "type": "boolean", "description": "Add the agent's current for-sale and for-rent listings (address, price, beds, baths, status, link). Needs **Full profile**. Charged per agent that has listings (see Pricing).", "default": false }, "maxListingsPerAgent": { "title": "Max listings per agent", "minimum": 1, "maximum": 500, "type": "integer", "description": "Active listings kept per agent when **Add active listings** is on. A Zillow profile shows a few listings only: the higher caps apply to Realtor.com.", "default": 50 }, "enrichEmails": { "title": "Find missing emails on agent websites (paid option)", "type": "boolean", "description": "For agents who have a website but no email on the sites, read that website (home page, then the contact and legal pages it links to, 3 pages at most) and add the email published there, tagged `website` in `emails`. Needs **Full profile** (the website is on it). Live mode only. Slower. With **Only agents with an email** on, an agent with a website but no email on the sites is judged after that visit. Charged per agent whose email is found (see Pricing).", "default": false }, "agentType": { "title": "Works with", "enum": [ "any", "buyers", "sellers" ], "type": "string", "description": "Buyers, sellers or both (Zillow `isBuying` / `isSelling`, Realtor.com agent type).", "default": "any" }, "topAgentsOnly": { "title": "Top agents only", "type": "boolean", "description": "Only Zillow Top Agents (badge given by Zillow on sales and reviews). The agents of the other sites are left out when this is on.", "default": false }, "specialties": { "title": "Specialties", "uniqueItems": true, "type": "array", "description": "Agents who list at least one of these specialties.", "items": { "type": "string", "enum": [ "first-time-home-buyers", "investment-properties", "rentals", "military-or-veterans", "luxury-homes", "new-construction", "property-management", "senior-communities", "relocation", "foreclosure", "lot-or-land", "vacation-short-term-rentals" ], "enumTitles": [ "First-time home buyers", "Investment properties", "Rentals", "Military / veterans", "Luxury homes", "New construction", "Property management", "Senior communities", "Relocation", "Foreclosure", "Lots / land", "Vacation / short-term rentals" ] }, "default": [] }, "languages": { "title": "Languages", "uniqueItems": true, "type": "array", "description": "Agents who speak at least one of these languages.", "items": { "type": "string", "enum": [ "american-sign-language", "arabic", "bengali", "cantonese", "farsi", "filipino", "french", "german", "greek", "haitian-creole", "hebrew", "hindi", "hungarian", "italian", "japanese", "korean", "mandarin", "polish", "portuguese", "russian", "spanish", "thai", "turkish", "ukrainian", "vietnamese" ], "enumTitles": [ "American Sign Language", "Arabic", "Bengali", "Cantonese", "Farsi", "Filipino", "French", "German", "Greek", "Haitian Creole", "Hebrew", "Hindi", "Hungarian", "Italian", "Japanese", "Korean", "Mandarin", "Polish", "Portuguese", "Russian", "Spanish", "Thai", "Turkish", "Ukrainian", "Vietnamese" ] }, "default": [] }, "minPrice": { "title": "Deal price from (USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Agents whose deals reach this price (Zillow price range, Realtor.com listing price range)." }, "maxPrice": { "title": "Deal price up to (USD)", "minimum": 0, "maximum": 1000000000, "type": "integer", "description": "Agents whose price range reaches below this price: an agent whose cheapest deals are under it is kept, even if the range goes much higher (Zillow price range, Realtor.com listing price range)." }, "postedAfter": { "title": "Active since", "type": "string", "description": "Only agents with a listing or a closed sale on or after this date (`lastActivityAt`): `2026-01-01`, or a period before now such as `90 days`, `6 months`. On Zillow only the last closed sale is dated, not the listings. Agents with no dated activity are dropped." }, "postedBefore": { "title": "Last active before", "type": "string", "description": "Only agents whose last listing or sale (`lastActivityAt`) is on or before this date (the whole day is included), or older than a period such as `1 year` (dormant agents). On Zillow only the last closed sale is dated, not the listings." }, "requireEmail": { "title": "Only agents with an email", "type": "boolean", "description": "Drop agents without an email address. With **Find missing emails on agent websites** on, an agent with a website is judged after that visit.", "default": false }, "requirePhone": { "title": "Only agents with a phone", "type": "boolean", "description": "Drop agents without any phone number.", "default": false }, "requireCellPhone": { "title": "Only agents with a cell phone", "type": "boolean", "description": "Drop agents without a phone marked as mobile / cell.", "default": false }, "brokerage": { "title": "Brokerage contains", "maxLength": 200, "type": "string", "description": "Only agents whose brokerage name contains this text (`keller williams`, case and accents ignored)." }, "minRating": { "title": "Minimum rating", "minimum": 0, "maximum": 5, "type": "number", "description": "Only agents rated at least this (0-5). Unrated agents are dropped when set." }, "minReviews": { "title": "Minimum reviews", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only agents with at least this many reviews." }, "minSalesLast12Months": { "title": "Minimum sales (12 months)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Only agents with at least this many closed sales in the last 12 months." }, "maxSalesLast12Months": { "title": "Maximum sales (12 months)", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Only agents with at most this many closed sales in the last 12 months (newer or part-time agents)." }, "minYearsExperience": { "title": "Minimum years of experience", "minimum": 0, "maximum": 80, "type": "integer", "description": "Only agents licensed or active for at least this many years." }, "maxYearsExperience": { "title": "Maximum years of experience", "minimum": 0, "maximum": 80, "type": "integer", "description": "Only agents active for at most this many years (recruiting new agents)." }, "minTotalSales": { "title": "Minimum total sales", "minimum": 0, "maximum": 100000, "type": "integer", "description": "Only agents with at least this many closed sales in their whole career on the site." }, "minActiveListings": { "title": "Minimum active listings", "minimum": 0, "maximum": 10000, "type": "integer", "description": "Only agents with at least this many listings for sale right now (1 = agents with listings)." }, "requireFields": { "title": "Required fields", "uniqueItems": true, "type": "array", "description": "Only agents where every field picked here is filled.", "items": { "type": "string", "enum": [ "website", "licenseNumber", "photoUrl", "bio", "videoUrl", "socialMedia.facebook", "socialMedia.instagram", "socialMedia.linkedin", "socialMedia.youtube", "socialMedia.x", "brokerageEmail" ], "enumTitles": [ "Website", "License number", "Photo", "Bio", "Video", "Facebook", "Instagram", "LinkedIn", "YouTube", "X (Twitter)", "Brokerage email" ] }, "default": [] }, "excludeTeams": { "title": "Exclude team profiles", "type": "boolean", "description": "Drop profiles that stand for a whole team (keep individual agents).", "default": false }, "teamLeadersOnly": { "title": "Team leaders only", "type": "boolean", "description": "Only agents who lead a team (Zillow team profiles).", "default": false }, "premiumOnly": { "title": "Paying advertisers only", "type": "boolean", "description": "Only agents who pay the site for leads (Zillow Premier Agent, Realtor.com paid agent): active buyers of marketing.", "default": false }, "realtorMembersOnly": { "title": "NAR members (REALTOR) only", "type": "boolean", "description": "Only agents flagged as members of the National Association of Realtors (Realtor.com flag).", "default": false }, "excludeKeywords": { "title": "Exclude keywords", "maxItems": 50, "uniqueItems": true, "type": "array", "description": "Drop agents whose name or brokerage contains one of these words (case and accents ignored).", "default": [], "items": { "type": "string" } }, "countOnly": { "title": "Count only (preview)", "type": "boolean", "description": "Return how many agents match the location and filters, split by state and source, without saving or charging any agent (the run start is still charged). The count is written to the run's key-value store (`COUNT`) and the status message.", "default": false }, "sortBy": { "title": "Sort database results by", "enum": [ "relevance", "salesLast12Months", "totalSales", "rating", "reviewCount", "lastActivity", "updatedAt" ], "type": "string", "description": "Order of the database agents (live mode keeps the sites' order).", "default": "relevance" }, "updatedWithinDays": { "title": "Refreshed within (days)", "minimum": 0, "maximum": 3650, "type": "integer", "description": "Only database agents whose record was refreshed from the sites within this many days. 0 = any age (each row carries `updatedAt`).", "default": 0 }, "databaseOffset": { "title": "Skip first matches", "minimum": 0, "maximum": 10000000, "type": "integer", "description": "Skip this many matching database agents (in a stable order) to fetch a large list in several runs.", "default": 0 }, "onlyNew": { "title": "Only new agents", "type": "boolean", "description": "Skip the agents that a previous run (same **Memory key**) already delivered: they are not saved and not charged, and their profile is not even opened. First run = everything is new.", "default": false }, "stateKey": { "title": "Memory key", "pattern": "^[a-zA-Z0-9_-]{1,64}$", "maxLength": 64, "type": "string", "description": "Name of the memory used by **Only new agents**. Give each schedule / task its own key (e.g. `austin-agents`) so that they do not share their memory. Letters, digits, `-` and `_`.", "default": "default" }, "resetState": { "title": "Reset the memory", "type": "boolean", "description": "Forget the agents delivered before under this **Memory key**, then run as a first run.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration (included proxy: paying users only)", "type": "object", "description": "Used for the Zillow requests (Realtor.com needs no proxy). Keep the default: it is included in the price. A residential proxy chosen here is refused (cost). Homes.com always goes through our included residential proxy, for paying Apify plans only: on the Apify free plan, add your own proxy URLs here to read Homes.com; without them Homes.com is skipped with a message (a run asking for Homes.com alone stops at once).", "default": { "useApifyProxy": true } }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 20, "type": "integer", "description": "Maximum parallel requests.", "default": 5 }, "maxRequestsPerMinute": { "title": "Max requests per minute", "minimum": 1, "maximum": 600, "type": "integer", "description": "Request rate cap for the whole run.", "default": 120 }, "minRequestIntervalMs": { "title": "Min pause between requests (ms)", "minimum": 0, "maximum": 60000, "type": "integer", "description": "Pause between two requests to the same site, in milliseconds.", "default": 0 }, "maxRequestRetries": { "title": "Max retries", "minimum": 0, "maximum": 10, "type": "integer", "description": "Retries per request before it is marked as failed. A request the site turns away is also retried on a new proxy session up to 10 times without using up these retries (Zillow).", "default": 5 }, "debugLog": { "title": "Debug log", "type": "boolean", "description": "Log every request.", "default": false } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }