{ "openapi": "3.0.1", "info": { "title": "Realtor.com Scraper - For Sale, Rent, Sold, No Login", "description": "Realtor.com homes for sale, for rent, sold and pending with price, beds, baths, sqft, address, coordinates, photos, listing agent and office with phone and email, estimates and flags. Full records add price and tax history and schools. Filters, radius search, 10,000+ per search. No login.", "version": "1.0", "x-build-id": "fyYFW0EY539IZebH8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/benthepythondev~realtor-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-benthepythondev-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/benthepythondev~realtor-com-scraper/runs": { "post": { "operationId": "runs-sync-benthepythondev-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/benthepythondev~realtor-com-scraper/run-sync": { "post": { "operationId": "run-sync-benthepythondev-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": { "locations": { "title": "Locations", "type": "array", "description": "City and state, ZIP code, county, neighborhood or street address, as you would type it on Realtor.com: \"Austin, TX\", \"78704\", \"Travis County, TX\", \"Brooklyn, NY\". A street address returns that one property.", "items": { "type": "string" } }, "startUrls": { "title": "Or: Realtor.com links", "type": "array", "description": "Search links (https://www.realtor.com/realestateandhomes-search/Austin_TX/beds-3, /apartments/Denver_CO, .../show-recently-sold) or property links (.../realestateandhomes-detail/..._M72854-81643). A property link returns its full record.", "items": { "type": "string" } }, "propertyIds": { "title": "Or: property ids", "type": "array", "description": "Realtor.com property ids (the digits after _M in a property link, without the hyphen), for example 7285481643. Each returns the full record.", "items": { "type": "string" } }, "listingType": { "title": "Listing type", "enum": [ "for_sale", "for_rent", "sold", "pending", "off_market" ], "type": "string", "description": "for_sale (active, without pending), for_rent, sold, pending (pending and contingent sales), or off_market.", "default": "for_sale" }, "maxResults": { "title": "Max results per search", "minimum": 1, "maximum": 100000, "type": "integer", "description": "How many properties to save for each location or search link. One search reaches 10,000 directly; above that the Actor splits it into date windows.", "default": 20 }, "includeDetails": { "title": "Include full records", "type": "boolean", "description": "Adds price history, tax history, nearby schools, all estimates, fees, parking and lease terms to every row (one extra call per 20 homes; charged as property-details).", "default": false }, "minPrice": { "title": "Min price", "minimum": 0, "type": "integer", "description": "List price for sale and rent; sale price for sold searches (sale prices are not public in non-disclosure states such as Texas)." }, "maxPrice": { "title": "Max price", "minimum": 0, "type": "integer", "description": "Upper bound of the price filter." }, "minBeds": { "title": "Min beds", "minimum": 0, "type": "integer", "description": "At least this many bedrooms." }, "maxBeds": { "title": "Max beds", "minimum": 0, "type": "integer", "description": "At most this many bedrooms." }, "minBaths": { "title": "Min baths", "minimum": 0, "type": "integer", "description": "At least this many bathrooms." }, "maxBaths": { "title": "Max baths", "minimum": 0, "type": "integer", "description": "At most this many bathrooms." }, "minSqft": { "title": "Min square feet", "minimum": 0, "type": "integer", "description": "Living area at least." }, "maxSqft": { "title": "Max square feet", "minimum": 0, "type": "integer", "description": "Living area at most." }, "minLotSqft": { "title": "Min lot square feet", "minimum": 0, "type": "integer", "description": "Lot size at least." }, "maxLotSqft": { "title": "Max lot square feet", "minimum": 0, "type": "integer", "description": "Lot size at most." }, "minYearBuilt": { "title": "Built in or after", "minimum": 1700, "type": "integer", "description": "Year built at least." }, "maxYearBuilt": { "title": "Built in or before", "minimum": 1700, "type": "integer", "description": "Year built at most." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Leave empty for all. single_family, condos, townhomes, multi_family, duplex_triplex, land, farm, mobile, apartment, condo_townhome_rowhome_coop, coop.", "items": { "type": "string", "enum": [ "single_family", "condos", "townhomes", "multi_family", "duplex_triplex", "land", "farm", "mobile", "apartment", "condo_townhome_rowhome_coop", "coop" ] } }, "daysOnMarket": { "title": "Listed or sold within days", "minimum": 1, "type": "integer", "description": "Only listings added (for sale, for rent, pending) or sold (sold searches) in the last N days." }, "radiusMiles": { "title": "Radius in miles", "minimum": 0.1, "maximum": 100, "type": "number", "description": "Search around the location's center (or an address) within this radius instead of inside its boundary." }, "sort": { "title": "Sort", "enum": [ "newest", "price_low", "price_high", "sqft_high", "recently_sold", "recently_updated" ], "type": "string", "description": "Realtor.com's own order when empty. Sold searches default to most recently sold." }, "foreclosureOnly": { "title": "Foreclosures only", "type": "boolean", "description": "Only foreclosure listings." }, "newConstructionOnly": { "title": "New construction only", "type": "boolean", "description": "Only new construction." }, "openHouseOnly": { "title": "Open houses only", "type": "boolean", "description": "Only listings with an upcoming open house." }, "debug": { "title": "Debug log", "type": "boolean", "description": "Logs every request with its size and time." } } }, "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 } } } } } } } } } }