{ "openapi": "3.0.1", "info": { "title": "Zillow Agents Scraper — Profiles & Leads", "description": "Scrape Zillow real estate agents by city, ZIP, directory URL, or profile URL. Returns contacts, brokerage, ratings, sales stats, specialties, languages, and source URLs.", "version": "0.4", "x-build-id": "fSpfwm1XKqrura1fj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/khadinakbar~zillow-agents-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-khadinakbar-zillow-agents-scraper", "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/khadinakbar~zillow-agents-scraper/runs": { "post": { "operationId": "runs-sync-khadinakbar-zillow-agents-scraper", "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/khadinakbar~zillow-agents-scraper/run-sync": { "post": { "operationId": "run-sync-khadinakbar-zillow-agents-scraper", "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": { "locations": { "title": "Locations", "type": "array", "description": "Use this when the user wants Zillow real estate agents in one or more US cities or ZIP codes. Accepts values like [\"Austin, TX\"] or [\"10001\", \"Miami, FL\"]. Defaults to [\"Austin, TX\"] when no start URLs are supplied. NOT a property address or listing URL.", "items": { "type": "string" }, "default": [ "Austin, TX" ] }, "startUrls": { "title": "Zillow agent URLs", "type": "array", "description": "Use this when the user already has Zillow agent directory or profile URLs. Accepts URLs like https://www.zillow.com/professionals/real-estate-agent-reviews/new-york-ny/ or https://www.zillow.com/profile/agent-name. Leave empty to search by locations. NOT for Zillow home listing URLs.", "items": { "type": "object", "properties": { "url": { "title": "URL", "type": "string", "description": "A Zillow agent directory URL or Zillow profile URL." } }, "required": [ "url" ] } }, "maxResults": { "title": "Max agents", "minimum": 1, "maximum": 500, "type": "integer", "description": "Use this to cap the number of Zillow agent records returned and billed. Accepted range is 1 to 500; for example, 25 costs at most $0.75 in agent events. Defaults to 5 for a fast first run. NOT a page count; the actor stops when this many validated agent rows are persisted.", "default": 5 }, "maxPagesPerLocation": { "title": "Max directory pages per location", "minimum": 1, "maximum": 25, "type": "integer", "description": "Use this when a location has many Zillow directory pages and you want to control breadth. Accepted range is 1 to 25; each page usually lists about 10-15 agents. Defaults to 3 for fast, bounded runs. NOT the max profile count; use Max agents for billing control.", "default": 3 }, "fetchProfiles": { "title": "Fetch full profile pages", "type": "boolean", "description": "Use this when you need richer fields from each Zillow profile, including phone, website, about text, specialties, languages, experience, and sales stats. Defaults to false for faster, more reliable directory rows. Set true for profile enrichment. NOT a paid email enrichment service; it only returns data visible on Zillow pages.", "default": false }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Use this only when you need to override the default Apify Residential US proxy used for Zillow. Defaults to Apify Proxy with RESIDENTIAL group and US country targeting. Most users should leave it unchanged. NOT a place for API keys or credentials.", "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 } } } } } } } } } }