{ "openapi": "3.0.1", "info": { "title": "Realtor.com Agent Scraper Recent Sold Listings", "description": "Realtor.com Agent Scraper extracts agent profiles and recent sold listings, including agent names, brokerage details, locations, property addresses, sale prices, dates, and listing URLs. Ideal for agent research, lead generation, market analysis, and real estate intelligence.", "version": "0.1", "x-build-id": "wtchU2qZvGr1fLPTF" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/simpleapi~realtor-com-agent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-simpleapi-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/simpleapi~realtor-com-agent-scraper/runs": { "post": { "operationId": "runs-sync-simpleapi-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/simpleapi~realtor-com-agent-scraper/run-sync": { "post": { "operationId": "run-sync-simpleapi-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": "📍 ZIP Codes", "type": "array", "description": "One or more US ZIP codes to pull agents from. Example: [\"90211\", \"33139\"]. Bulk input supported.", "items": { "type": "string" } }, "maxItemsPerZipcode": { "title": "🔢 Agents Per ZIP", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Cap on how many agents to collect per ZIP code. Example: 10 returns the top 10 agents for the chosen sort. Default is 10.", "default": 10 }, "sortOrder": { "title": "🔀 Agent Ranking", "enum": [ "RELEVANT_AGENTS", "RATINGS_REVIEWS", "MOST_SALES", "MOST_RECENT_ACTIVITY", "TESTIMONIALS_RECOMMENDATIONS" ], "type": "string", "description": "Order in which agents are ranked within each ZIP.", "default": "RELEVANT_AGENTS" }, "includeActiveStats": { "title": "💵 Price Band & Active Listings", "type": "boolean", "description": "Add each agent's annual price band (priceRangeMin/Max) plus active-listing count, list-price band, and last-listing date. Data comes from the same request — no extra cost. Default is true.", "default": true }, "includeRecentSales": { "title": "🏡 Recent-Sold Listing Rows", "type": "boolean", "description": "Emit one extra child row per recent-sold preview (beds, baths, city, state, photo) beneath each agent, and add a recentSoldListingsCount to the agent row. Default is true. Note: previews carry no sale price/address/date.", "default": true }, "maxListingsPerAgent": { "title": "🔢 Max Sold Rows Per Agent", "minimum": 0, "maximum": 100, "type": "integer", "description": "Cap the number of recent-sold child rows per agent. Example: 3 keeps up to 3 preview rows each. Use 0 for unlimited. Default is 10.", "default": 10 }, "maxRetries": { "title": "🔁 Max Retries", "minimum": 1, "maximum": 10, "type": "integer", "description": "Per-request retry attempts before rotating the proxy IP. Default is 3.", "default": 3 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Starts direct (no proxy). On a block or WAF shell it auto-falls back to datacenter, then sticky residential with retries." } } }, "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 } } } } } } } } } }