{ "openapi": "3.0.1", "info": { "title": "Realtor US Scraper - Real Estate Listings", "description": "Extract United States Realtor.com homes for sale, rentals, and sold listings by city, ZIP code, or coordinate radius. Filter by price, beds, baths, size, property type, pets, tours, status, and dates, then export results as JSON, CSV, Excel, or API data for market research and lead generation.", "version": "0.0", "x-build-id": "UnBLIKOqqAKkBUxep" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/igolaizola~realtor-us-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-igolaizola-realtor-us-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/igolaizola~realtor-us-scraper/runs": { "post": { "operationId": "runs-sync-igolaizola-realtor-us-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/igolaizola~realtor-us-scraper/run-sync": { "post": { "operationId": "run-sync-igolaizola-realtor-us-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", "type": "string", "description": "U.S. city, ZIP code, or other place text to search. Matching places are discovered and the best result is selected." }, "locationType": { "title": "Location type", "enum": [ "auto", "city", "zip" ], "type": "string", "description": "Optional place type to prefer when matching Location. Auto selects the highest-ranked match; City and ZIP code narrow the match.", "default": "auto" }, "latitude": { "title": "Latitude", "minimum": -90, "maximum": 90, "type": "number", "description": "Optional latitude for a radius search. Provide it together with longitude and radius." }, "longitude": { "title": "Longitude", "minimum": -180, "maximum": 180, "type": "number", "description": "Optional longitude for a radius search. Provide it together with latitude and radius." }, "radiusMiles": { "title": "Radius (miles)", "minimum": 1, "maximum": 50, "type": "number", "description": "Search radius around the coordinates, from 1 to 50 miles. Coordinates take precedence over Location." }, "listingType": { "title": "Listing type", "enum": [ "sale", "rent", "sold" ], "type": "string", "description": "Choose whether to collect homes for sale, rent, or recently sold homes.", "default": "sale" }, "maxItems": { "title": "Maximum listings", "minimum": 0, "type": "integer", "description": "Maximum number of listings to collect. Use 0 for unlimited results (subject to the available run allowance).", "default": 100 }, "fetchDetails": { "title": "Fetch expanded details", "type": "boolean", "description": "Fetch additional property, photo, pet-policy, promotion, and contact fields for each listing. Adds one request per listing and increases runtime and usage.", "default": false }, "sortBy": { "title": "Sort results by", "enum": [ "relevance", "newest", "lowestPrice", "highestPrice" ], "type": "string", "description": "Choose how listings are ordered.", "default": "relevance" }, "minPrice": { "title": "Minimum price", "minimum": 0, "type": "integer", "description": "Minimum listing price in U.S. dollars.", "default": 0 }, "maxPrice": { "title": "Maximum price", "minimum": 0, "type": "integer", "description": "Maximum listing price in U.S. dollars.", "default": 0 }, "minBeds": { "title": "Minimum bedrooms", "minimum": 0, "type": "integer", "description": "Minimum number of bedrooms.", "default": 0 }, "maxBeds": { "title": "Maximum bedrooms", "minimum": 0, "type": "integer", "description": "Maximum number of bedrooms.", "default": 0 }, "minBaths": { "title": "Minimum bathrooms", "minimum": 0, "type": "number", "description": "Minimum number of bathrooms.", "default": 0 }, "maxBaths": { "title": "Maximum bathrooms", "minimum": 0, "type": "number", "description": "Maximum number of bathrooms.", "default": 0 }, "minSqft": { "title": "Minimum living area (sq ft)", "minimum": 0, "type": "integer", "description": "Minimum interior living area in square feet.", "default": 0 }, "maxSqft": { "title": "Maximum living area (sq ft)", "minimum": 0, "type": "integer", "description": "Maximum interior living area in square feet.", "default": 0 }, "minLotSqft": { "title": "Minimum lot size (sq ft)", "minimum": 0, "type": "integer", "description": "Minimum lot size in square feet.", "default": 0 }, "maxLotSqft": { "title": "Maximum lot size (sq ft)", "minimum": 0, "type": "integer", "description": "Maximum lot size in square feet.", "default": 0 }, "minYearBuilt": { "title": "Earliest year built", "minimum": 0, "type": "integer", "description": "Earliest construction year.", "default": 0 }, "maxYearBuilt": { "title": "Latest year built", "minimum": 0, "type": "integer", "description": "Latest construction year.", "default": 0 }, "maxHoaFee": { "title": "Maximum HOA fee", "minimum": 0, "type": "integer", "description": "Maximum homeowners association fee in U.S. dollars.", "default": 0 }, "noHoaFee": { "title": "No HOA fee", "type": "boolean", "description": "Include only listings without a homeowners association fee.", "default": false }, "homeCategories": { "title": "Home category", "type": "array", "description": "Choose the kind of home listing to include.", "items": { "type": "string", "enum": [ "homes", "newConstructionPlans", "moveInReadyHomes" ], "enumTitles": [ "Existing homes", "New-construction plans", "Move-in-ready new homes" ] } }, "propertyTypes": { "title": "Property type", "type": "array", "description": "Choose one or more property types to include.", "items": { "type": "string", "enum": [ "apartment", "condo", "coOp", "condOp", "farm", "land", "mobileHome", "multiFamilyHome", "singleFamilyHome", "townhome" ], "enumTitles": [ "Apartment", "Condo", "Co-op", "Cond-op", "Farm", "Land", "Mobile home", "Multi-family home", "Single-family home", "Townhome" ] } }, "cats": { "title": "Allows cats", "type": "boolean", "description": "Include rental listings that allow cats.", "default": false }, "dogs": { "title": "Allows dogs", "type": "boolean", "description": "Include rental listings that allow dogs.", "default": false }, "noPetsAllowed": { "title": "No pets allowed", "type": "boolean", "description": "Include rental listings that do not allow pets.", "default": false }, "foreclosure": { "title": "Foreclosures only", "type": "boolean", "description": "Include foreclosure listings only.", "default": false }, "newConstruction": { "title": "New construction only", "type": "boolean", "description": "Include new-construction listings only.", "default": false }, "promotionPresent": { "title": "Promoted listings only", "type": "boolean", "description": "Include promoted listings only.", "default": false }, "excludePendingContingent": { "title": "Exclude pending and contingent", "type": "boolean", "description": "Exclude pending and contingent listings.", "default": false }, "hasOpenHouse": { "title": "Open house available", "type": "boolean", "description": "Include listings with an open house.", "default": false }, "hasTour": { "title": "Tour available", "type": "boolean", "description": "Include listings with a property tour.", "default": false }, "hasVirtualTour": { "title": "Virtual tour available", "type": "boolean", "description": "Include listings with a virtual tour.", "default": false }, "has3dTour": { "title": "3D tour available", "type": "boolean", "description": "Include listings with a 3D tour.", "default": false }, "listedSince": { "title": "Listed since", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Earliest listing date, in YYYY-MM-DD format." }, "priceReducedSince": { "title": "Price reduced since", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Earliest price-reduction date, in YYYY-MM-DD format." }, "moveInDate": { "title": "Available from", "pattern": "^(\\d{4})-(0[1-9]|1[0-2])-(0[1-9]|[12]\\d|3[01])$", "type": "string", "description": "Earliest rental availability date, in YYYY-MM-DD format." } } }, "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 } } } } } } } } } }