{ "openapi": "3.0.1", "info": { "title": "Realtor.com Agent Scraper Experience Specialties", "description": "Realtor.com Agent Scraper extracts agent experience, specialties, profiles, locations, brokerage details, ratings, contact info, and profile URLs. Ideal for agent research, lead generation, real estate prospecting, market analysis, and competitive intelligence.", "version": "0.1", "x-build-id": "5tM8B62D4NHiFn4DK" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/scrapio~realtor-com-agent-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-scrapio-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/scrapio~realtor-com-agent-scraper/runs": { "post": { "operationId": "runs-sync-scrapio-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/scrapio~realtor-com-agent-scraper/run-sync": { "post": { "operationId": "run-sync-scrapio-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", "properties": { "zipCodes": { "title": "📮 Target Zip Codes", "type": "array", "description": "One or more US zip codes to pull agents from. Example: [\"33139\", \"90211\"]. Each zip is paged independently.", "items": { "type": "string" } }, "maxItemsPerZipcode": { "title": "🔢 Agents Per Zip Code", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Upper bound on agents returned per zip code. Example: 25 → up to 25 agent profiles for each 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 agents are pulled in. RATINGS_REVIEWS surfaces the most reviewed (and best-enriched) agents first.", "default": "RELEVANT_AGENTS" }, "enrichProfile": { "title": "🎓 Add Experience & Specialties", "type": "boolean", "description": "Fetch and append the enrichment block per agent: bio, experience years, specialties, designations, spoken languages, license number, MLS IDs, average rating and recommendations. Uses the same request the base already makes (no extra HTTP cost). Default is true.", "default": true }, "filterBySpecialty": { "title": "🏷️ Keep Only These Specialties", "type": "array", "description": "Case-insensitive keep-only filter. If set, an agent is kept only when at least one of their specialties contains one of these terms. Example: [\"Luxury\", \"Waterfront\"]. Leave empty to keep all. Requires enrichment ON.", "default": [], "items": { "type": "string" } }, "filterByLanguage": { "title": "🗣️ Keep Only These Languages", "type": "array", "description": "Case-insensitive keep-only filter on spoken languages. Example: [\"Spanish\"] keeps only agents listing Spanish. Note: agents with no listed language are dropped when this is set. Leave empty to keep all. Requires enrichment ON.", "default": [], "items": { "type": "string" } }, "aiEnhancement": { "title": "🤖 AI Bio Summary", "type": "boolean", "description": "When on, condense each agent's bio into a one-line `bio_summary` via your own LLM key. Off by default; keyless runs return the full structured output with `bio_summary` = null.", "default": false }, "aiModel": { "title": "🧠 AI Model / Provider", "enum": [ "claude-haiku-4-5", "claude-sonnet-5", "claude-opus-4-8", "gpt-4o-mini", "gpt-4o", "gpt-4.1-mini", "o3-mini", "gemini-2.0-flash-lite", "gemini-2.0-flash", "gemini-2.5-flash", "grok-3-mini", "deepseek-chat", "sonar", "mistral-small-latest" ], "type": "string", "description": "Provider auto-detected from the name: claude-*=Anthropic, gpt-*/o1/o3=OpenAI, gemini-*=Google, grok-*=xAI, deepseek-*=DeepSeek, sonar*=Perplexity, mistral-*=Mistral. Cheaper mini/flash/haiku models are recommended for summaries.", "default": "claude-haiku-4-5" }, "aiApiKey": { "title": "🔑 AI API Key", "type": "string", "description": "Your provider API key (used only when AI Bio Summary is on). Falls back to env vars per provider: ANTHROPIC_API_KEY / OPENAI_API_KEY / GEMINI_API_KEY / XAI_API_KEY / DEEPSEEK_API_KEY / PERPLEXITY_API_KEY / MISTRAL_API_KEY." }, "maxRetries": { "title": "🔁 Max Retries Per Request", "minimum": 1, "maximum": 10, "type": "integer", "description": "How many times a blocked/unstable request is retried before rotating the proxy IP. Default is 3.", "default": 3 }, "proxyConfiguration": { "title": "🌐 Proxy", "type": "object", "description": "Starts direct (no proxy). On a block/soft-block it auto-falls back to datacenter, then sticky residential with IP rotation. Enable Apify Proxy here to start on a proxy instead." } } }, "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 } } } } } } } } } }