{ "openapi": "3.0.1", "info": { "title": "Redfin Real Estate Listings Scraper", "description": "Scrape for-sale home listings from any Redfin city or ZIP code. Get price, beds, baths, sqft, lot size, year built, days on market, HOA, coordinates, MLS number and agent remarks. No login, no API key. Filter by price, size, type and freshness. Cheapest Redfin scraper on the store.", "version": "0.0", "x-build-id": "0bDN92beA38M4TM4M" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/mangudai~redfin-real-estate-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-mangudai-redfin-real-estate-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/mangudai~redfin-real-estate-scraper/runs": { "post": { "operationId": "runs-sync-mangudai-redfin-real-estate-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/mangudai~redfin-real-estate-scraper/run-sync": { "post": { "operationId": "run-sync-mangudai-redfin-real-estate-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": { "startUrls": { "title": "Redfin regions", "type": "array", "description": "Redfin city URLs (for example https://www.redfin.com/city/30818/TX/Austin), bare 5-digit ZIP codes, or an explicit \"regionType:regionId\" pair such as 6:30818. One region per line.", "default": [ "https://www.redfin.com/city/30818/TX/Austin", "https://www.redfin.com/city/17151/CA/San-Francisco" ], "items": { "type": "string" } }, "maxItemsPerRegion": { "title": "Max listings per region", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many listings to request per region. Redfin serves up to roughly 350 per region reliably.", "default": 350 }, "maxItems": { "title": "Max listings in total", "minimum": 0, "type": "integer", "description": "Stop the run once this many listings have been saved. Leave at 0 for no cap.", "default": 0 }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Limit results to these property types. Leave empty for every type.", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "multi-family", "land", "manufactured", "other" ], "enumTitles": [ "House", "Condo / Co-op", "Townhouse", "Multi-family", "Land", "Manufactured", "Other" ] }, "default": [] }, "minPrice": { "title": "Min price (USD)", "type": "integer", "description": "Drop listings priced below this." }, "maxPrice": { "title": "Max price (USD)", "type": "integer", "description": "Drop listings priced above this." }, "minBeds": { "title": "Min bedrooms", "type": "integer", "description": "Drop listings with fewer bedrooms." }, "maxBeds": { "title": "Max bedrooms", "type": "integer", "description": "Drop listings with more bedrooms." }, "minBaths": { "title": "Min bathrooms", "type": "integer", "description": "Drop listings with fewer bathrooms." }, "minSqft": { "title": "Min interior sqft", "type": "integer", "description": "Drop listings smaller than this." }, "maxSqft": { "title": "Max interior sqft", "type": "integer", "description": "Drop listings larger than this." }, "minYearBuilt": { "title": "Min year built", "type": "integer", "description": "Drop listings built before this year." }, "maxDaysOnMarket": { "title": "Max days on market", "type": "integer", "description": "Keep only fresh listings, for example 7 for the past week." }, "keyword": { "title": "Keyword", "type": "string", "description": "Keep only listings whose address, neighborhood, tags or agent remarks contain this text, for example \"pool\"." }, "includeDescription": { "title": "Include agent remarks", "type": "boolean", "description": "Add the full listing description written by the agent. Turn off for smaller rows.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify Proxy keeps requests spread across IPs. Recommended.", "default": { "useApifyProxy": true } } } }, "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 } } } } } } } } } }