{ "openapi": "3.0.1", "info": { "title": "HomeLight Scraper [$0.95/1K💰] | Agent Leads | Reviews", "description": "Scrape HomeLight real estate agents by market: licences, 12-month homes sold, sales volume, service areas, certifications and reviews. Export to CSV, JSON or API for agent recruiting.", "version": "0.0", "x-build-id": "7CdhcbVWRC8KM8jMq" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/ahmed_jasarevic~homelight-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-ahmed_jasarevic-homelight-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/ahmed_jasarevic~homelight-scraper/runs": { "post": { "operationId": "runs-sync-ahmed_jasarevic-homelight-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/ahmed_jasarevic~homelight-scraper/run-sync": { "post": { "operationId": "run-sync-ahmed_jasarevic-homelight-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": "Markets (area slugs or directory URLs)", "type": "array", "description": "HomeLight market slugs or top-agent directory URLs, e.g. \"atlanta-ga\", \"houston-tx\" or \"https://www.homelight.com/atlanta-ga/top-real-estate-agents\". Neighborhood slugs also work (e.g. \"atlanta-ga/inman-park\"). When Max agents is higher than the ~40 agents one feed returns, the Actor automatically adds the neighborhood feeds of each requested market.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (optional)", "type": "array", "description": "Additional HomeLight market directory URLs or individual agent profile URLs (https://www.homelight.com/agents/).", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "maxAgents": { "title": "Max agents", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Number of unique agent records to deliver to the agents dataset. HomeLight returns ~40 agents per directory feed, so the Actor automatically expands into neighborhood feeds until the limit is reached (or the market has no more agents).", "default": 10 }, "maxConcurrency": { "title": "Max concurrency", "minimum": 1, "maximum": 50, "type": "integer", "description": "Number of parallel HTTP requests. Higher values finish runs faster but put more load on HomeLight. 25 is a good default for this plain-HTTP crawler.", "default": 25 }, "includeDetails": { "title": "Fetch agent details (turn off for fast mode)", "type": "boolean", "description": "Fetch each agent's profile page (service areas, certifications, reviews, contact options, full details) and optionally transactions. Turn off for a fast, cheap crawl that returns only the fields in the area agent feed. Details are billed as one `agent-detail` pay-per-event event per agent; reviews require details.", "default": true }, "includeTransactions": { "title": "Compute 12-month production stats", "type": "boolean", "description": "Fetch each agent's transaction history and compute homes sold in the last 12 months, sales volume and average price point. Requires agent details. Adds one cheap JSON request per agent.", "default": true }, "includeReviews": { "title": "Include reviews (separate dataset, billed per review)", "type": "boolean", "description": "Save individual reviews (reviewer, text, rating, date, relationship) to a separate reviews dataset. Requires agent details. Each review is charged as one `review` pay-per-event event.", "default": true }, "maxReviewsPerAgent": { "title": "Max reviews per agent", "minimum": 0, "maximum": 50, "type": "integer", "description": "How many reviews to keep per agent (HomeLight shows up to 10 on the profile page).", "default": 5 }, "maxRequestsPerCrawl": { "title": "Max requests per run (safety cap)", "minimum": 1, "type": "integer", "description": "Hard safety cap on HTTP requests. Leave empty to derive it from Max agents." }, "proxy": { "title": "Proxy configuration", "type": "object", "description": "Select proxies to be used by your crawler." } } }, "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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }