{ "openapi": "3.0.1", "info": { "title": "Realtor.com Scraper - US Real Estate Listings", "description": "Realtor.com data extraction without API or login. Export for-sale, rent & sold listings to CSV/JSON — a Realtor.com API alternative.", "version": "1.0", "x-build-id": "qm4N6PAL4QCr09KQ0" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/logiover~realtor-com-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-logiover-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/logiover~realtor-com-scraper/runs": { "post": { "operationId": "runs-sync-logiover-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/logiover~realtor-com-scraper/run-sync": { "post": { "operationId": "run-sync-logiover-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", "type": "string", "description": "City + state, ZIP code, county or neighborhood to search. Examples: 'Austin, TX', 'Miami, FL', '90210', 'Brooklyn, NY'. Leave empty to use the Metro quick-pick or the default metro." }, "metro": { "title": "Metro (quick pick)", "enum": [ "", "Houston, TX", "Austin, TX", "Dallas, TX", "San Antonio, TX", "Miami, FL", "Orlando, FL", "Tampa, FL", "Jacksonville, FL", "Atlanta, GA", "Charlotte, NC", "Nashville, TN", "Phoenix, AZ", "Las Vegas, NV", "Denver, CO", "Chicago, IL", "New York, NY", "Los Angeles, CA", "San Diego, CA", "San Francisco, CA", "Seattle, WA", "Portland, OR", "Boston, MA", "Philadelphia, PA", "Washington, DC" ], "type": "string", "description": "Optional shortcut — pick a popular US metro instead of typing a Location. Ignored if Location or Search URLs are provided. Empty input defaults to Houston, TX.", "default": "" }, "listingType": { "title": "Listing type", "enum": [ "forSale", "forRent", "sold" ], "type": "string", "description": "Which listings to collect for the Location above.", "default": "forSale" }, "propertyType": { "title": "Property type", "enum": [ "", "single_family", "condos", "townhomes", "multi_family", "mobile", "farm", "land" ], "type": "string", "description": "Filter to a single property type. Leave as 'Any' for all types.", "default": "" }, "searchUrls": { "title": "Search URLs (optional)", "type": "array", "description": "Optional. Paste Realtor.com search-result URLs to scrape instead of the Location builder. Example: 'https://www.realtor.com/realestateandhomes-search/Austin_TX'. If set, these take priority over Location.", "items": { "type": "string" } }, "minPrice": { "title": "Min price ($)", "minimum": 0, "type": "integer", "description": "Only return listings at or above this price. Leave empty for no minimum." }, "maxPrice": { "title": "Max price ($)", "minimum": 0, "type": "integer", "description": "Only return listings at or below this price. Leave empty for no maximum." }, "minBeds": { "title": "Min beds", "minimum": 0, "type": "integer", "description": "Minimum number of bedrooms. Leave empty for any." }, "minBaths": { "title": "Min baths", "minimum": 0, "type": "integer", "description": "Minimum number of bathrooms. Leave empty for any." }, "sortBy": { "title": "Sort by", "enum": [ "relevant", "newest", "price_low", "price_high" ], "type": "string", "description": "Result ordering.", "default": "relevant" }, "maxResults": { "title": "Max results", "minimum": 1, "type": "integer", "description": "Maximum number of listings to collect across the whole run. Default 200 keeps runs fast; the actor paginates to thousands when raised.", "default": 200 }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Realtor.com requires US residential proxies. Leave the default (Apify Proxy · RESIDENTIAL · US).", "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 } } } } } } } } } }