{ "openapi": "3.0.1", "info": { "title": "Realtor.Com Agent Scraper With Phone Social Leads", "description": "Realtor.com Agent Scraper extracts real estate agent profiles, phone numbers, social links, names, specialties, locations, ratings, and profile URLs. Ideal for real estate lead generation, agent prospecting, contact discovery, market research, and competitive intelligence.", "version": "0.1", "x-build-id": "7GU6kxGIjiBzwoMWf" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/api-empire~realtor-com-agent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-api-empire-realtor-com-agent-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/api-empire~realtor-com-agent-scraper/runs": { "post": { "operationId": "runs-sync-api-empire-realtor-com-agent-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/api-empire~realtor-com-agent-scraper/run-sync": { "post": { "operationId": "run-sync-api-empire-realtor-com-agent-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", "required": [ "zipCodes" ], "properties": { "zipCodes": { "title": "๐Ÿ“ฎ Target Zip Codes", "type": "array", "description": "Zip codes to pull agent leads from. Add as many as you like โ€” each is searched separately. Example: [\"07101\", \"90211\"].", "items": { "type": "string" } }, "maxItemsPerZipcode": { "title": "๐ŸŽฏ Leads Per Zip Code", "minimum": 1, "maximum": 10000, "type": "integer", "description": "How many agents to collect from each zip code before moving on. Example: 25 โ†’ up to 25 agent leads per zip. Default is 10.", "default": 10 }, "sortOrder": { "title": "โ†•๏ธ Result Ranking", "enum": [ "RELEVANT_AGENTS", "RATINGS_REVIEWS", "MOST_SALES", "MOST_RECENT_ACTIVITY", "TESTIMONIALS_RECOMMENDATIONS" ], "type": "string", "description": "Order in which Realtor.com returns agents for each zip. RATINGS_REVIEWS and TESTIMONIALS_RECOMMENDATIONS surface higher-quality leads (which also carry the most social links). Default is RELEVANT_AGENTS.", "default": "RELEVANT_AGENTS" }, "includeSocialLinks": { "title": "๐Ÿ”— Extract Social Profile Links", "type": "boolean", "description": "Add Facebook, Instagram, LinkedIn, X, YouTube and TikTok profile URLs to each agent lead (whenever the agent publishes them). Turn off for a lighter, contact-only export. Default is true.", "default": true }, "requirePhone": { "title": "๐Ÿ“ž Only Agents With a Phone Number", "type": "boolean", "description": "Drop any agent that has no mobile or office phone, so every exported lead is callable. Example: 24 found, 3 phoneless โ†’ 21 rows. Default is false (keep all).", "default": false }, "dedupeAgents": { "title": "๐Ÿงน Merge Duplicate Agents Across Zip Codes", "type": "boolean", "description": "The same agent often appears under several nearby zip codes. Turn on to output ONE merged row per agent, with every zip they were found under listed in 'zips_served'. Default is false (one row per agent per zip).", "default": false }, "maxRetries": { "title": "๐Ÿ” Max Retries Per Request", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times to retry a blocked or unstable request (rotating proxy IP) before giving up. Default is 3.", "default": 3 }, "proxyConfiguration": { "title": "๐ŸŒ Proxy Configuration", "type": "object", "description": "Starts with a direct connection. If Realtor.com's anti-bot layer blocks a request, the actor automatically escalates to datacenter, then sticky residential proxies. Enable Apify Proxy here to start proxied from the first request." } } }, "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 } } } } } } } } } }