{ "openapi": "3.0.1", "info": { "title": "Redfin Home Listings Scraper: For Sale and Sold Homes", "description": "Get US homes for sale and recently sold homes from Redfin by ZIP code, city or Redfin search URL. Price, beds, baths, square feet, lot, year built, days on market, sold date and sold price, photos and listing URL in one clean table.", "version": "1.0", "x-build-id": "chbxpoQQPZAG2VqcY" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/pistachio_implementation~redfin-home-listings-for-sale-sold/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-pistachio_implementation-redfin-home-listings-for-sale-sold", "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/pistachio_implementation~redfin-home-listings-for-sale-sold/runs": { "post": { "operationId": "runs-sync-pistachio_implementation-redfin-home-listings-for-sale-sold", "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/pistachio_implementation~redfin-home-listings-for-sale-sold/run-sync": { "post": { "operationId": "run-sync-pistachio_implementation-redfin-home-listings-for-sale-sold", "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", "required": [ "locations" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "One per line. A 5 digit ZIP code (78704), a city with its state code (Austin, TX), or any redfin.com search URL for a city, ZIP, neighborhood or county. A Redfin URL that already has filters in it (for example /filter/min-beds=3,include=sold-3mo) keeps those filters and ignores the filter fields below.", "items": { "type": "string" } }, "status": { "title": "Listing status", "enum": [ "forSale", "sold" ], "type": "string", "description": "For sale returns active and coming soon listings. Sold returns homes sold within the period you pick below.", "default": "forSale" }, "soldWithinDays": { "title": "Sold within (days)", "enum": [ "7", "30", "90", "180", "365", "730", "1095", "1825" ], "type": "string", "description": "Only used when status is Sold.", "default": "90" }, "maxItemsPerLocation": { "title": "Max listings per location", "minimum": 1, "maximum": 10000, "type": "integer", "description": "Stop after this many listings for each location. Large areas are split by price automatically to go past Redfin's 350 per search cap.", "default": 200 }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Leave empty for all types.", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "multiFamily", "land", "other", "manufactured", "coop" ], "enumTitles": [ "House", "Condo", "Townhouse", "Multi family", "Land", "Other", "Manufactured", "Cooperative" ] } }, "minPrice": { "title": "Min price (USD)", "minimum": 0, "type": "integer", "description": "Lowest list price, or lowest sold price for sold searches." }, "maxPrice": { "title": "Max price (USD)", "minimum": 0, "type": "integer", "description": "Highest list price, or highest sold price for sold searches." }, "minBeds": { "title": "Min bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "At least this many bedrooms." }, "maxBeds": { "title": "Max bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "At most this many bedrooms." }, "minBaths": { "title": "Min bathrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "At least this many bathrooms." }, "minSqft": { "title": "Min square feet", "minimum": 0, "type": "integer", "description": "Smallest interior size." }, "maxSqft": { "title": "Max square feet", "minimum": 0, "type": "integer", "description": "Largest interior size." }, "minYearBuilt": { "title": "Built in or after", "minimum": 1700, "maximum": 2100, "type": "integer", "description": "Earliest year built." }, "maxYearBuilt": { "title": "Built in or before", "minimum": 1700, "maximum": 2100, "type": "integer", "description": "Latest year built." }, "includeAllPhotos": { "title": "Include all photo URLs", "type": "boolean", "description": "Off: only the main photo URL. On: every photo URL of the listing (up to 100).", "default": false }, "proxyConfiguration": { "title": "Proxy", "type": "object", "description": "Not needed in most cases. The actor works without a proxy.", "default": { "useApifyProxy": 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 } } } } } } } } } }