{ "openapi": "3.0.1", "info": { "title": "Realtor.com Scraper — US Sold Comps, ZIP & Monitor", "description": "Scrape Realtor.com sold comps, for-sale, and rental listings by ZIP or city. Get sold price, sold date, beds, sqft, GPS, photos, and agent phone. Monitor new sales. Realtor API alternative for Python, Node.js, and MCP.", "version": "0.1", "x-build-id": "xgsWODxDHVbDeOLIN" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/crawloop~realtor-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-crawloop-realtor-com-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/crawloop~realtor-com-scraper/runs": { "post": { "operationId": "runs-sync-crawloop-realtor-com-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/crawloop~realtor-com-scraper/run-sync": { "post": { "operationId": "run-sync-crawloop-realtor-com-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": "ZIP codes", "type": "array", "description": "US ZIP codes to scrape (primary builder). Each ZIP is a separate sold/sale/rent search with the filters below. Example: 78704, 90210.", "items": { "type": "string" } }, "locations": { "title": "Cities / neighborhoods", "type": "array", "description": "Fallback when you do not have ZIPs. Examples: Austin, TX or Zilker, Austin, TX.", "items": { "type": "string" } }, "startUrls": { "title": "Start URLs (search or listing)", "type": "array", "description": "Paste Realtor.com search URLs or /realestateandhomes-detail/ links. Path filters (solds, type, beds, price) are applied automatically.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "type": "string", "title": "URL of a web page", "format": "uri" } } } }, "listingStatus": { "title": "Listing status", "enum": [ "sold", "for_sale", "for_rent" ], "type": "string", "description": "Builder only (ignored when the Start URL already encodes sold/sale/rent). Default is sold comps.", "default": "sold" }, "soldWithinDays": { "title": "Sold within (days)", "minimum": 1, "maximum": 730, "type": "integer", "description": "Keep sold listings with last_sold_date in the last N days (1–730). Applies to sold searches. Default 30. Public search commonly returns 12+ months — unlike 6-month-only scrapers.", "default": 30 }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Optional. Leave empty for all types.", "items": { "type": "string", "enum": [ "single_family", "condos", "townhomes", "multi_family", "mobile", "land", "farm" ], "enumTitles": [ "Single family", "Condo", "Townhome", "Multi-family", "Mobile / manufactured", "Land", "Farm" ] } }, "minPrice": { "title": "Min price ($)", "type": "integer", "description": "Minimum list price, or sold/close price when status is sold." }, "maxPrice": { "title": "Max price ($)", "type": "integer", "description": "Maximum list price, or sold/close price when status is sold." }, "minBeds": { "title": "Min bedrooms", "type": "integer", "description": "Minimum bedroom count. Studios are 0." }, "maxBeds": { "title": "Max bedrooms", "type": "integer", "description": "Maximum bedroom count." }, "minSqft": { "title": "Min living sqft", "type": "integer", "description": "Minimum interior square footage." }, "maxItems": { "title": "Max listings", "minimum": 1, "type": "integer", "description": "Maximum number of listings to save per run (across all ZIPs/URLs).", "default": 50 }, "includeDetails": { "title": "Scrape full property details", "type": "boolean", "description": "Fetch each home's description, tax parcel, extra photos, and price history. Off by default — search cards already include sold price, date, beds, sqft, GPS, and agent phone.", "default": false }, "monitorMode": { "title": "Monitor mode (new / changed only)", "type": "boolean", "description": "On scheduled re-runs, save only properties that are new or whose status/price changed since the last run on this Actor. Use for 'new sold this week' comps.", "default": false }, "maxConcurrency": { "title": "Max concurrent detail requests", "minimum": 1, "maximum": 20, "type": "integer", "description": "How many property-detail requests to run in parallel when details are on. Default 8.", "default": 8 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy. US RESIDENTIAL is recommended for stable access to Realtor.com on Apify Cloud.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } } }, "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 } } } } } } } } } }