{ "openapi": "3.0.1", "info": { "title": "Realtor Agents Scraper — Fast API & Leads", "description": "Scrape Realtor.com agents by US city, state, ZIP, or search URL. Use for real-estate lead generation and market research; not property listings. Returns profiles, brokerages, ratings, reviews, production metrics, markets, and optional public contacts. Charged $0.005 per agent.", "version": "2.1", "x-build-id": "TYrt61ykf249D39x1" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/muhammadafzal~fast-realtor-agents-api-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-muhammadafzal-fast-realtor-agents-api-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/muhammadafzal~fast-realtor-agents-api-scraper/runs": { "post": { "operationId": "runs-sync-muhammadafzal-fast-realtor-agents-api-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/muhammadafzal~fast-realtor-agents-api-scraper/run-sync": { "post": { "operationId": "run-sync-muhammadafzal-fast-realtor-agents-api-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": "US locations", "maxItems": 50, "type": "array", "description": "Use this when searching agents by place. Enter US city/state or ZIP strings, for example [\"Austin, TX\",\"90210\"]. Defaults to [\"Austin, TX\"] and supports up to 50 locations. Do not put Realtor.com URLs here; use Start URLs instead.", "items": { "type": "string" }, "default": [ "Austin, TX" ] }, "startUrls": { "title": "Realtor.com start URLs", "maxItems": 50, "type": "array", "description": "Use this when you already have Realtor.com agent-directory URLs, for example https://www.realtor.com/realestateagents/New-York_NY. URLs must use realtor.com and start with /realestateagents. Defaults to an empty list; when supplied, these URLs replace Locations. Do not provide individual property-listing URLs.", "items": { "type": "object", "properties": { "url": { "title": "Agent directory URL", "type": "string", "description": "A public Realtor.com /realestateagents search URL. Example: https://www.realtor.com/realestateagents/New-York_NY" } }, "required": [ "url" ] }, "default": [] }, "maxResults": { "title": "Maximum agent results", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Use this to cap agents saved across all locations. Enter an integer such as 100. Defaults to 25; allowed range is 1–5,000 and result-event cost is capped at maxResults × $0.005. This is not a page limit.", "default": 25 }, "includeProfileDetails": { "title": "Enrich agent profiles", "type": "boolean", "description": "Use this when public phone, website, address, languages, specialties, or service areas are worth extra API calls. Defaults to false for the fastest path. Realtor.com usually does not expose agent email addresses through this API, so email remains null unless the source adds it in the future.", "default": false }, "maxConcurrency": { "title": "Profile API concurrency", "minimum": 1, "maximum": 12, "type": "integer", "description": "Use this to tune simultaneous profile-enrichment API calls. Enter an integer such as 6. Defaults to 6; allowed range is 1–12. Search pagination remains controlled and this is not the number of locations or results.", "default": 6 } } }, "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 } } } } } } } } } }