{ "openapi": "3.0.1", "info": { "title": "Redfin Scraper — US Homes for Sale, Price Cuts & New Listings", "description": "Redfin homes for sale in any US city, ZIP or neighborhood, one row per listing: price, beds, baths, size, lot, year built, HOA, days on market, map position. Run it again or on a schedule for price cuts, new and removed listings since the last run. Price, bedroom and type filters. No login.", "version": "0.1", "x-build-id": "vVbSa9GDcZhZg8Wf8" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/northbell~redfin-homes-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-northbell-redfin-homes-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/northbell~redfin-homes-scraper/runs": { "post": { "operationId": "runs-sync-northbell-redfin-homes-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/northbell~redfin-homes-scraper/run-sync": { "post": { "operationId": "run-sync-northbell-redfin-homes-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", "required": [ "locations" ], "properties": { "locations": { "title": "Locations", "type": "array", "description": "One place per line: a city (\"Austin, TX\"), a borough or neighborhood (\"Brooklyn, NY\", \"Hyde Park, Austin, TX\"), a ZIP code (\"78701\"), or a Redfin page URL (redfin.com/city/…, /neighborhood/…, /county/…, /zipcode/…). A city, neighborhood or county URL gives exactly the homes Redfin lists for that place (filters in the URL are ignored, use the fields below), and is the way to read a whole county. Counties and states cannot be typed by name.", "items": { "type": "string" } }, "maxHomesPerLocation": { "title": "Max homes per location", "minimum": 1, "maximum": 2000, "type": "integer", "description": "How many homes to return for each location, newest listings first. Redfin lists thousands of homes in a big city, so raise this (up to 2,000) or split the city into ZIP codes if you want everything. Price cuts and new listings are found among the homes read, and removed listings are only counted when every matching home was read.", "default": 200 }, "minPrice": { "title": "Minimum price (USD)", "minimum": 0, "type": "integer", "description": "Only homes listed at this price or more. Homes with no price shown are left out when a price limit is set." }, "maxPrice": { "title": "Maximum price (USD)", "minimum": 0, "type": "integer", "description": "Only homes listed at this price or less. Homes with no price shown are left out when a price limit is set." }, "minBeds": { "title": "Minimum bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Only homes with at least this many bedrooms. Land has no bedrooms and is left out when this is above 0." }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Only these kinds of property. Leave empty for all of them.", "items": { "type": "string", "enum": [ "house", "condo", "townhouse", "multi-family", "land", "mobile" ], "enumTitles": [ "House", "Condo / co-op", "Townhouse", "Multi-family (2-4 units)", "Land", "Mobile / manufactured" ] } }, "onlyChanges": { "title": "Only new listings and price changes", "type": "boolean", "description": "From the second run of a search, return only homes that are new since your last run or whose price changed. Unchanged homes are skipped and not charged. The first run of a search always returns everything.", "default": false }, "includeRemoved": { "title": "Include removed listings", "type": "boolean", "description": "From the second run, add a free row for each home that was in your last run but is no longer listed (sold, withdrawn, or no longer matching your filters). Only given when every matching home was read.", "default": 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 }, "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 } } } } } } } } } }