# Redfin Listings Scraper (`velvety_bedbug/redfin-listings-scraper`) Actor - **URL**: https://apify.com/velvety\_bedbug/redfin-listings-scraper.md - **Developed by:** [Peters Bugs](https://apify.com/velvety_bedbug) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN bookmarks - **User rating**: No ratings yet ## Pricing Pay per usage This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-usage ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Actors are written with capital "A". ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README undefined # Actor input Schema ## `zipCode` (type: `string`): US ZIP to search (e.g. '10001'). Resolved to a Redfin region ID. ## `status` (type: `string`): for_sale: active listings. sold: recently sold. pending: contract pending. ## `minPrice` (type: `integer`): Lower bound on list price. ## `maxPrice` (type: `integer`): Upper bound on list price. ## `minBeds` (type: `integer`): 0 = studio allowed. ## `maxBeds` (type: `integer`): Upper bound. 0 or empty = unlimited. ## `minBaths` (type: `number`): Supports 1.0, 1.5, 2.0, etc. ## `minSqft` (type: `integer`): Minimum living area. ## `maxSqft` (type: `integer`): Maximum living area. ## `minYearBuilt` (type: `integer`): Earliest construction year. ## `maxYearBuilt` (type: `integer`): Latest construction year. ## `minLotSize` (type: `integer`): Minimum lot size. ## `maxLotSize` (type: `integer`): Maximum lot size. ## `maxHoaPerMonth` (type: `integer`): Upper bound on HOA fee ($/mo). 0 = no limit. ## `maxPropertyTax` (type: `integer`): Upper bound on monthly property tax. 0 = no limit. ## `minPricePerSqft` (type: `integer`): Lower bound on price per square foot. ## `maxPricePerSqft` (type: `integer`): Upper bound on price per square foot. ## `propertyTypes` (type: `array`): Multi-select property types. Empty = all. Values: house, condo, townhouse, multi_family, land, other, mobile, coop ## `minStories` (type: `integer`): Minimum number of stories. ## `maxStories` (type: `integer`): Maximum number of stories. ## `excludeAgeRestricted` (type: `boolean`): Hide age-restricted / senior communities. ## `excludeLand` (type: `boolean`): Skip vacant land. ## `openHousesOnly` (type: `boolean`): Only show listings with an upcoming open house. ## `virtualTourOnly` (type: `boolean`): Only show listings with a virtual/3D tour. ## `redfinListingsOnly` (type: `boolean`): Only show homes listed by Redfin agents. ## `minWalkScore` (type: `integer`): Minimum Walk Score. ## `minBikeScore` (type: `integer`): Minimum Bike Score. ## `minTransitScore` (type: `integer`): Minimum Transit Score. ## `minSchoolRating` (type: `integer`): Minimum assigned-school GreatSchools rating. ## `regionId` (type: `string`): Bypass ZIP → region lookup. Use a specific region_id (e.g. '3243'). ## `regionType` (type: `string`): Region type code (2=zipcode, 5=city, 1=neighborhood). ## `maxItems` (type: `integer`): Maximum listings to return. ## `proxyConfiguration` (type: `object`): Apify residential proxy recommended. ## Actor input object example ```json { "zipCode": "10001", "status": "for_sale", "minPrice": 0, "maxPrice": 100000000, "minBeds": 0, "maxBeds": 0, "minBaths": 0, "minSqft": 0, "maxSqft": 0, "minYearBuilt": 0, "maxYearBuilt": 0, "minLotSize": 0, "maxLotSize": 0, "maxHoaPerMonth": 0, "maxPropertyTax": 0, "minPricePerSqft": 0, "maxPricePerSqft": 0, "propertyTypes": [], "minStories": 0, "maxStories": 0, "excludeAgeRestricted": false, "excludeLand": false, "openHousesOnly": false, "virtualTourOnly": false, "redfinListingsOnly": false, "minWalkScore": 0, "minBikeScore": 0, "minTransitScore": 0, "minSchoolRating": 0, "regionId": "", "regionType": "2", "maxItems": 10, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } } ```` # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }; // Run the Actor and wait for it to finish const run = await client.actor("velvety_bedbug/redfin-listings-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], "apifyProxyCountry": "US", } } # Run the Actor and wait for it to finish run = client.actor("velvety_bedbug/redfin-listings-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ], "apifyProxyCountry": "US" } }' | apify call velvety_bedbug/redfin-listings-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=velvety_bedbug/redfin-listings-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Listings Scraper", "version": "0.0", "x-build-id": "MSSd3soCj26xDdrRy" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/velvety_bedbug~redfin-listings-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-velvety_bedbug-redfin-listings-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/velvety_bedbug~redfin-listings-scraper/runs": { "post": { "operationId": "runs-sync-velvety_bedbug-redfin-listings-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/velvety_bedbug~redfin-listings-scraper/run-sync": { "post": { "operationId": "run-sync-velvety_bedbug-redfin-listings-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": { "zipCode": { "title": "ZIP code", "type": "string", "description": "US ZIP to search (e.g. '10001'). Resolved to a Redfin region ID.", "default": "10001" }, "status": { "title": "Listing status", "enum": [ "for_sale", "sold", "pending" ], "type": "string", "description": "for_sale: active listings. sold: recently sold. pending: contract pending.", "default": "for_sale" }, "minPrice": { "title": "Min price ($)", "minimum": 0, "type": "integer", "description": "Lower bound on list price.", "default": 0 }, "maxPrice": { "title": "Max price ($)", "minimum": 0, "type": "integer", "description": "Upper bound on list price.", "default": 100000000 }, "minBeds": { "title": "Min bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "0 = studio allowed.", "default": 0 }, "maxBeds": { "title": "Max bedrooms", "minimum": 0, "maximum": 10, "type": "integer", "description": "Upper bound. 0 or empty = unlimited.", "default": 0 }, "minBaths": { "title": "Min bathrooms", "minimum": 0, "maximum": 10, "type": "number", "description": "Supports 1.0, 1.5, 2.0, etc.", "default": 0 }, "minSqft": { "title": "Min square feet", "minimum": 0, "type": "integer", "description": "Minimum living area.", "default": 0 }, "maxSqft": { "title": "Max square feet", "minimum": 0, "type": "integer", "description": "Maximum living area.", "default": 0 }, "minYearBuilt": { "title": "Min year built", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Earliest construction year.", "default": 0 }, "maxYearBuilt": { "title": "Max year built", "minimum": 0, "maximum": 2100, "type": "integer", "description": "Latest construction year.", "default": 0 }, "minLotSize": { "title": "Min lot size (sqft)", "minimum": 0, "type": "integer", "description": "Minimum lot size.", "default": 0 }, "maxLotSize": { "title": "Max lot size (sqft)", "minimum": 0, "type": "integer", "description": "Maximum lot size.", "default": 0 }, "maxHoaPerMonth": { "title": "Max HOA fee/month ($)", "minimum": 0, "type": "integer", "description": "Upper bound on HOA fee ($/mo). 0 = no limit.", "default": 0 }, "maxPropertyTax": { "title": "Max property tax/month ($)", "minimum": 0, "type": "integer", "description": "Upper bound on monthly property tax. 0 = no limit.", "default": 0 }, "minPricePerSqft": { "title": "Min $/sqft", "minimum": 0, "type": "integer", "description": "Lower bound on price per square foot.", "default": 0 }, "maxPricePerSqft": { "title": "Max $/sqft", "minimum": 0, "type": "integer", "description": "Upper bound on price per square foot.", "default": 0 }, "propertyTypes": { "title": "Property types", "type": "array", "description": "Multi-select property types. Empty = all. Values: house, condo, townhouse, multi_family, land, other, mobile, coop", "default": [], "items": { "type": "string" } }, "minStories": { "title": "Min stories", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum number of stories.", "default": 0 }, "maxStories": { "title": "Max stories", "minimum": 0, "maximum": 10, "type": "integer", "description": "Maximum number of stories.", "default": 0 }, "excludeAgeRestricted": { "title": "Exclude 55+ communities", "type": "boolean", "description": "Hide age-restricted / senior communities.", "default": false }, "excludeLand": { "title": "Exclude land listings", "type": "boolean", "description": "Skip vacant land.", "default": false }, "openHousesOnly": { "title": "Open houses only", "type": "boolean", "description": "Only show listings with an upcoming open house.", "default": false }, "virtualTourOnly": { "title": "Virtual tour only", "type": "boolean", "description": "Only show listings with a virtual/3D tour.", "default": false }, "redfinListingsOnly": { "title": "Redfin listings only", "type": "boolean", "description": "Only show homes listed by Redfin agents.", "default": false }, "minWalkScore": { "title": "Min walk score (0–100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum Walk Score.", "default": 0 }, "minBikeScore": { "title": "Min bike score (0–100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum Bike Score.", "default": 0 }, "minTransitScore": { "title": "Min transit score (0–100)", "minimum": 0, "maximum": 100, "type": "integer", "description": "Minimum Transit Score.", "default": 0 }, "minSchoolRating": { "title": "Min school GreatSchools rating (1–10)", "minimum": 0, "maximum": 10, "type": "integer", "description": "Minimum assigned-school GreatSchools rating.", "default": 0 }, "regionId": { "title": "[Advanced] Redfin region ID", "type": "string", "description": "Bypass ZIP → region lookup. Use a specific region_id (e.g. '3243').", "default": "" }, "regionType": { "title": "[Advanced] Redfin region type", "type": "string", "description": "Region type code (2=zipcode, 5=city, 1=neighborhood).", "default": "2" }, "maxItems": { "title": "Max listings", "minimum": 1, "maximum": 500, "type": "integer", "description": "Maximum listings to return.", "default": 10 }, "proxyConfiguration": { "title": "Proxy configuration", "type": "object", "description": "Apify residential proxy recommended." } } }, "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 } } } } } } } } } } ```