{ "openapi": "3.0.1", "info": { "title": "Redfin Scraper & New Listings Monitor - Price Drop Alerts", "description": "For investors, agents and home buyers who want new-listing alerts: Redfin homes for sale by city, ZIP, neighborhood or county, newest first, with price, beds, baths, sqft, lot, year built, HOA, days on market and photos. Watch mode returns only new listings and price drops. Export as CSV or Excel.", "version": "0.1", "x-build-id": "2RWCvs5zsXIyMRDsP" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/neverempty~redfin-listings-monitor/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-neverempty-redfin-listings-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/neverempty~redfin-listings-monitor/runs": { "post": { "operationId": "runs-sync-neverempty-redfin-listings-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/neverempty~redfin-listings-monitor/run-sync": { "post": { "operationId": "run-sync-neverempty-redfin-listings-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": { "locations": { "title": "Places (Redfin page or ZIP code)", "type": "array", "description": "One per line: a 5-digit ZIP code (78704) or the address of a Redfin city, ZIP, neighborhood or county page, such as https://www.redfin.com/city/30818/TX/Austin (open the place on redfin.com and copy the address without /filter/). Up to 20 places per run. If empty, Austin, TX is searched.", "items": { "type": "string" } }, "maxResultsPerSearch": { "title": "Max listings per place", "minimum": 1, "maximum": 350, "type": "integer", "description": "How many homes for sale to return for each place, newest on Redfin first (1 to 350; Redfin shows at most 350 per search). Empty means 50. In watch mode this caps what one run returns; the rest comes in later runs." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Optional. Only these property types, as Redfin classifies them. Empty means all types.", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "multi-family", "land", "manufactured", "co-op", "other" ], "enumTitles": [ "House", "Condo", "Townhouse", "Multi-family", "Land", "Manufactured", "Co-op", "Other" ] } }, "minPrice": { "title": "Minimum price (USD)", "minimum": 1000, "type": "integer", "description": "Optional. Only homes listed at or above this price in US dollars. Homes without a shown price are left out when this is set. Empty means no minimum." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 1000, "type": "integer", "description": "Optional. Only homes listed at or below this price in US dollars. Empty means no maximum." }, "minBeds": { "title": "Minimum bedrooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Optional. Only homes with at least this many bedrooms (1 to 10). Homes that do not state bedrooms are left out when this is set. Empty means any." }, "minBaths": { "title": "Minimum bathrooms", "minimum": 1, "maximum": 10, "type": "integer", "description": "Optional. Only homes with at least this many bathrooms (1 to 10; half baths count as 0.5). Empty means any." }, "onlyNew": { "title": "Watch mode: only new listings and price drops", "type": "boolean", "description": "Run the same input on a schedule. The first run returns the newest listings and remembers them; later runs return only homes that appeared on Redfin since then and remembered homes whose price went down. Empty means off (a plain search).", "default": false }, "includePriceDrops": { "title": "Include price drops (watch mode)", "type": "boolean", "description": "In watch mode, also return remembered homes whose list price went down, with the previous price. Empty means on.", "default": true }, "watchName": { "title": "Watch name (watch mode)", "type": "string", "description": "Optional. Keeps separate memories for separate watches of the same place and filters (letters, digits, dot, dash, underscore). Empty means the default watch." }, "resetMonitoringState": { "title": "Start the watch again (watch mode)", "type": "boolean", "description": "Forget what this watch remembered and treat this run as the first check. Empty means off.", "default": false } } }, "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 } } } } } } } } } }