{ "openapi": "3.0.1", "info": { "title": "Realtor.com Property Search & Change Monitor", "description": "Search public Realtor.com property cards, collect supported exact-property details, compare source values, or monitor verified changes.", "version": "0.9", "x-build-id": "XF8p1daS0aUardUUa" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/luminar~realtor-property-change-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-luminar-realtor-property-change-monitor", "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/luminar~realtor-property-change-monitor/runs": { "post": { "operationId": "runs-sync-luminar-realtor-property-change-monitor", "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/luminar~realtor-property-change-monitor/run-sync": { "post": { "operationId": "run-sync-luminar-realtor-property-change-monitor", "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": { "workflow": { "title": "What do you want to do?", "enum": [ "search_properties", "scrape_exact_properties", "monitor_market_or_properties", "find_comparables" ], "type": "string", "description": "Choose one buyer job. Exact URLs request the verified public detail contract. Monitoring seeds a baseline first and reports only factual source-field changes on later compatible runs.", "default": "search_properties" }, "location": { "title": "Location, city/state, or ZIP", "maxLength": 120, "type": "string", "description": "Primary location for search, monitoring, or comparables. Examples: Austin, TX or 78701.", "default": "Austin, TX" }, "additionalLocations": { "title": "More locations", "maxItems": 19, "uniqueItems": true, "type": "array", "description": "Optional additional cities, state-qualified places, or ZIP codes. Each location becomes a separate coverage target.", "items": { "type": "string", "minLength": 1, "maxLength": 120 } }, "listingStatus": { "title": "Listing market", "enum": [ "for_sale", "for_rent", "sold" ], "type": "string", "description": "Select the source market to search. It becomes part of the monitoring scope.", "default": "for_sale" }, "maxProperties": { "title": "Maximum properties, changes, or comparables", "minimum": 1, "maximum": 5000, "type": "integer", "description": "Hard result ceiling. Search cards support up to 5,000 rows; full public details support up to 2,000 because each property uses four bounded official operations. Capped monitoring never commits incomplete state.", "default": 10 }, "detailLevel": { "title": "How much public data per property?", "enum": [ "search_cards", "full_public_details" ], "type": "string", "description": "Search cards are the cheapest route. Full details additionally requests the public property, history/tax, neighborhood/school, and environmental-risk operations; incomplete detail rows are returned free and never committed to monitoring state.", "default": "search_cards" }, "propertyTypes": { "title": "Property types", "maxItems": 12, "uniqueItems": true, "type": "array", "description": "Optional normalized source property types, such as single_family, condo, or townhome.", "items": { "type": "string", "maxLength": 60 } }, "minPrice": { "title": "Minimum price", "minimum": 0, "maximum": 10000000000, "type": "number", "description": "Keep properties at or above this source-published price." }, "maxPrice": { "title": "Maximum price", "minimum": 0, "maximum": 10000000000, "type": "number", "description": "Keep properties at or below this source-published price." }, "minBeds": { "title": "Minimum bedrooms", "minimum": 0, "maximum": 100, "type": "number", "description": "Minimum published bedroom count." }, "maxBeds": { "title": "Maximum bedrooms", "minimum": 0, "maximum": 100, "type": "number", "description": "Maximum published bedroom count." }, "minBaths": { "title": "Minimum bathrooms", "minimum": 0, "maximum": 100, "type": "number", "description": "Minimum published bathroom count." }, "maxBaths": { "title": "Maximum bathrooms", "minimum": 0, "maximum": 100, "type": "number", "description": "Maximum published bathroom count." }, "minLivingAreaSqft": { "title": "Minimum living area", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Minimum published living area." }, "maxLivingAreaSqft": { "title": "Maximum living area", "minimum": 0, "maximum": 1000000, "type": "number", "description": "Maximum published living area." }, "minLotSizeSqft": { "title": "Minimum lot size", "minimum": 0, "maximum": 1000000000, "type": "number", "description": "Minimum published lot size." }, "maxLotSizeSqft": { "title": "Maximum lot size", "minimum": 0, "maximum": 1000000000, "type": "number", "description": "Maximum published lot size." }, "keywords": { "title": "Must contain these words", "maxItems": 20, "uniqueItems": true, "type": "array", "description": "Optional case-insensitive terms checked in published description, address, and feature data.", "items": { "type": "string", "maxLength": 80 } }, "sort": { "title": "Result order", "enum": [ "source_order", "newest", "price_low", "price_high" ], "type": "string", "description": "Deterministic output order. Source order preserves the fetched search placement.", "default": "source_order" }, "searchUrls": { "title": "Existing Realtor.com search URLs", "maxItems": 20, "type": "array", "description": "Optional public search pages. When supplied, they replace generated location targets and preserve their canonical URL as scope provenance.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "title": "Search URL", "description": "One public Realtor.com search-results URL.", "type": "string", "pattern": "^https://(?:www\\.)?realtor\\.com/", "maxLength": 1200 } } } }, "propertyUrls": { "title": "Exact public Realtor.com property URLs", "maxItems": 2000, "type": "array", "description": "Used only by Collect exact property URLs. Only public Realtor.com URLs are supported; login and private account data are excluded.", "items": { "type": "object", "required": [ "url" ], "properties": { "url": { "title": "Property URL", "description": "One public Realtor.com sale-detail or rental-detail URL with a stable property ID.", "type": "string", "pattern": "^https://(?:www\\.)?realtor\\.com/(?:realestateandhomes-detail|rentals/details)/.+_M[0-9]+-[0-9]+/?(?:[?#].*)?$", "maxLength": 1200 } } } }, "stateNamespace": { "title": "Monitoring scope name", "pattern": "^[A-Za-z0-9._~-]{1,64}$", "maxLength": 64, "type": "string", "description": "Stable name that separates monitoring snapshots. Changing targets, filters, limits, or sorting creates a different scope fingerprint.", "default": "default" }, "includeUnchanged": { "title": "Also include the current unchanged snapshot", "type": "boolean", "description": "Monitoring only. Adds free current property rows alongside paid change events. It does not turn unchanged rows into changes.", "default": false }, "referenceProperty": { "title": "Reference property for comparables", "type": "object", "description": "Comparables only. Supply source-backed values. Output shows arithmetic differences and a declared deterministic order; it does not estimate value or investment quality.", "properties": { "propertyId": { "title": "Property ID", "description": "Source-published stable Realtor property ID.", "type": "string" }, "canonicalUrl": { "title": "Canonical URL", "description": "Public Realtor.com URL for the reference property.", "type": "string" }, "propertyType": { "title": "Property type", "description": "Source-published property type.", "type": "string" }, "listPrice": { "title": "List price", "description": "Source-published list price used only for arithmetic differences.", "type": "number" }, "soldPrice": { "title": "Sold price", "description": "Source-published sold price used only for arithmetic differences.", "type": "number" }, "beds": { "title": "Bedrooms", "description": "Source-published bedroom count.", "type": "number" }, "baths": { "title": "Bathrooms", "description": "Source-published bathroom count.", "type": "number" }, "livingAreaSqft": { "title": "Living area", "description": "Source-published living area in square feet.", "type": "number" }, "latitude": { "title": "Latitude", "description": "Source-published latitude for deterministic distance ordering.", "type": "number" }, "longitude": { "title": "Longitude", "description": "Source-published longitude for deterministic distance ordering.", "type": "number" }, "yearBuilt": { "title": "Year built", "description": "Source-published construction year.", "type": "integer" } }, "additionalProperties": false }, "maxBuyerChargeUsd": { "title": "Maximum projected Actor charge", "minimum": 0.01, "maximum": 1000, "type": "number", "description": "When event pricing is active, the run stops before source work if the maximum event vector could exceed this amount. Pricing is not active during private preparation.", "default": 1 }, "maxPagesPerTarget": { "title": "Page guard", "minimum": 1, "maximum": 250, "type": "integer", "description": "Internal per-target pagination ceiling.", "default": 1 }, "maxRequests": { "title": "Request guard", "minimum": 1, "maximum": 12000, "type": "integer", "description": "Internal run-wide source request ceiling.", "default": 12000 }, "maxSourceBytes": { "title": "Transfer guard", "minimum": 10000, "maximum": 1500000000, "type": "integer", "description": "Internal run-wide source transfer ceiling.", "default": 1500000000 }, "maxRuntimeSecs": { "title": "Runtime guard", "minimum": 30, "maximum": 7200, "type": "integer", "description": "Internal source-work runtime ceiling.", "default": 7200 }, "maxEstimatedPlatformUsd": { "title": "Platform-cost guard", "minimum": 0.01, "maximum": 3, "type": "number", "description": "Run-wide infrastructure planning ceiling; settled Cloud usage remains required before pricing.", "default": 1 } } }, "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 } } } } } } } } } }