{ "openapi": "3.0.1", "info": { "title": "Realtor.com Scraper — Homes, Rentals & Sold Listings", "description": "Collect US Realtor.com property listings by city, ZIP code or search URL. Export addresses, prices, sale dates, bedrooms, bathrooms, floor area, agents and photos for investors, proptech and mortgage teams.", "version": "0.1", "x-build-id": "qKa48cegBpWZPnRo0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/s-r~realtor-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-s-r-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/s-r~realtor-com-scraper/runs": { "post": { "operationId": "runs-sync-s-r-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/s-r~realtor-com-scraper/run-sync": { "post": { "operationId": "run-sync-s-r-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": { "location": { "title": "Location", "minLength": 1, "type": "string", "description": "US city and state, ZIP code, county or neighbourhood. Required unless url is provided." }, "url": { "title": "Url", "minLength": 1, "type": "string", "description": "Realtor.com search or property URL. URL location, status and filters take precedence over the corresponding fields." }, "status": { "title": "Status", "enum": [ "for_sale", "for_rent", "sold" ], "type": "string", "description": "Listing status; for_sale includes ready-to-build listings. A search URL sets its own status.", "default": "for_sale" }, "limit": { "title": "Limit", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Maximum unique properties over all cursor pages. The source exposes at most 10,000 rows per search.", "default": 100 }, "property_type": { "title": "Property type", "type": "array", "description": "One or more property types. Output retains Realtor.com type names.", "items": { "type": "string" } }, "sort": { "title": "Sort", "enum": [ "newest", "price_low", "price_high" ], "type": "string", "description": "Explicit stable sort: newest listing date (sold date for sold) or asking price ascending/descending.", "default": "newest" }, "sold_within_days": { "title": "Sold within days", "minimum": 1, "maximum": 3650, "type": "integer", "description": "Only for sold searches: include sales within this many days. Future sale dates are always excluded." }, "cursor": { "title": "Cursor", "minLength": 1, "maxLength": 350000, "type": "string", "description": "Opaque next_cursor from a previous response. Retain the original location, URL and filters; limit may be reduced to the remaining volume." }, "min_price": { "title": "Min price", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Minimum asking price in USD (monthly for rentals)." }, "max_price": { "title": "Max price", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Maximum asking price in USD (monthly for rentals)." }, "min_beds": { "title": "Min beds", "minimum": 0, "maximum": 20, "type": "integer", "description": "Minimum bedrooms." }, "max_beds": { "title": "Max beds", "minimum": 0, "maximum": 20, "type": "integer", "description": "Maximum bedrooms." }, "min_baths": { "title": "Min baths", "minimum": 0, "maximum": 20, "type": "integer", "description": "Minimum bathrooms." }, "min_sqft": { "title": "Min sqft", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Minimum living area in square feet." }, "max_sqft": { "title": "Max sqft", "minimum": 0, "maximum": 9007199254740991, "type": "integer", "description": "Maximum living area in square feet." } } }, "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 } } } } } } } } } }