# Redfin Property Discovery Scraper (`trovevault/redfin-property-discovery-scraper`) Actor Discover public Redfin sale listings by location and property type. Extract descriptions, prices, areas, rooms, features, images, brokers, and URLs. - **URL**: https://apify.com/trovevault/redfin-property-discovery-scraper.md - **Developed by:** [Trove Vault](https://apify.com/trovevault) (community) - **Categories:** Real estate - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $0.85 / 1,000 listings This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event ## 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/docs.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python/docs.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/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 ## Redfin Property Discovery Scraper Discover public Redfin sale listings from buyer-facing inputs: location, operation, property type, and result limit. The Actor returns structured listing rows with descriptions, prices, area, price per square meter, rooms, main image, features, broker name, and listing URLs. This is a discovery Actor. You do not need to provide search result URLs. ### Why Use This Actor Use this Actor when you need a clean sale-listing dataset from Redfin without manually building search URLs or copying listings from the website. It is useful for: - US real estate lead discovery by major city or ZIP code - sale inventory checks on Redfin - price and area comparison across Redfin listings - monitoring broker supply in large US markets - TroveVault pipelines that combine several property portals into one dataset ### What It Extracts Each dataset row can include: - `platform`, `listingId`, `title`, and `url` - `operation` and `propertyType` - `price`, `currency`, `priceText`, and `pricePerM2` - `areaM2`, `bedrooms`, and `bathrooms` - `address`, `city`, and `country` - `description` - `features`, such as Redfin key facts, listing tags, virtual tour, video, 3D tour, new construction, or hot home - `sellerName` - `mainImage` and `images` - `listedAtText` - `scrapedAt` - `runId` when supplied in the input Fields are only populated when they are publicly visible in Redfin listing data. ### Input ```json { "location": "New York, NY", "operation": "sale", "propertyType": "any", "maxItems": 3, "datasetId": "", "runId": "" } ```` #### Input Fields - `location` - Major US city or ZIP code to search. City-level searches are recommended for stable results, for example `New York, NY`, `Los Angeles, CA`, `Chicago, IL`, `Dallas, TX`, `Austin, TX`, or `Seattle, WA`. - `operation` - Dropdown. Use `sale` for properties for sale. Redfin rental pages currently require an AWS WAF browser flow and are not enabled in this first build. - `propertyType` - Dropdown. Use `any`, `apartment`, `house`, `land`, or `commercial`. - `maxItems` - Maximum number of listings to save. Use a small number for quick checks and a larger number for broader discovery. - `datasetId` - Optional Apify dataset ID. When provided, each saved listing is also appended to that dataset, which is useful when combining several discovery Actors. - `runId` - Optional workflow run ID. When provided, it is copied into each output row and the `RUN_SUMMARY` key-value record. ### Output Example ```json { "platform": "Redfin", "listingId": "221245692", "title": "21414 104 Ave, Queens Village, NY, 11429", "url": "https://www.redfin.com/NY/Queens-Village/21414-104th-Ave-11429/home/20737417", "operation": "sale", "propertyType": "house", "price": 750000, "currency": "USD", "priceText": "750000 USD", "pricePerM2": 5814, "areaM2": 129, "bedrooms": 4, "bathrooms": 3, "address": "21414 104 Ave, Queens Village, NY, 11429", "city": "Queens Village", "country": "United States", "description": "Welcome to this spacious Colonial home featuring 4 generously sized bedrooms...", "features": ["spacious driveway", "off-street parking", "4,000 sq ft lot"], "sellerName": "Skylight Real Estate Consultan", "mainImage": "https://ssl.cdn-redfin.com/photo/269/mbphoto/686/genMid.1023686_0.webp", "images": ["https://ssl.cdn-redfin.com/photo/269/mbphoto/686/genMid.1023686_0.webp"], "listedAtText": "Active", "scrapedAt": "2026-07-24T10:30:00.000Z", "runId": "parent-workflow-run" } ``` ### API Usage ```bash curl -X POST "https://api.apify.com/v2/acts/trovevault~redfin-property-discovery-scraper/runs" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"location":"New York, NY","operation":"sale","propertyType":"any","maxItems":3}' ``` To append rows to an existing dataset and tag them with a workflow run: ```bash curl -X POST "https://api.apify.com/v2/acts/trovevault~redfin-property-discovery-scraper/runs" \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"location":"New York, NY","operation":"sale","propertyType":"any","maxItems":50,"datasetId":"YOUR_DATASET_ID","runId":"YOUR_PARENT_RUN_ID"}' ``` ### Notes And Limitations - Use English values for `operation` and `propertyType`; the Actor maps them internally to Redfin filters. - This first build supports major US sale markets and ZIP-code discovery. The region resolver can be expanded as we add more Redfin coverage. - Redfin rental pages currently require an AWS WAF browser flow, so rental discovery is not exposed in the input schema for this version. - The Actor does not return private contact details and does not bypass logins, paywalls, or private contact flows. ### Related Actors - Zillow Property Discovery Scraper - Realtor.com Property Discovery Scraper - Homes.com Property Discovery Scraper - Apartments.com Property Discovery Scraper - Trulia Property Discovery Scraper ### Changelog #### 0.1 - Initial Redfin sale discovery Actor with dropdown operation/property type, optional pipeline IDs, description extraction from listing remarks, price-per-square-meter calculation, and low-cost default test input. # Actor input Schema ## `location` (type: `string`): Major US city or ZIP code to search. Use English names, for example New York, NY; Los Angeles, CA; Chicago, IL; Dallas, TX; Austin, TX; Seattle, WA; or 10001. City-level searches are usually more precise and stable than broad regions. ## `operation` (type: `string`): Sale listings are supported in this version. Redfin rental pages currently require an AWS WAF browser flow and are not enabled. ## `propertyType` (type: `string`): Choose the type of property to discover. Use Any to return the broadest listing set supported by Redfin. ## `maxItems` (type: `integer`): Maximum number of property listings to return. Use smaller values for quick checks and higher values for broader market discovery. ## `datasetId` (type: `string`): Optional Apify dataset ID to append each saved listing to, in addition to this run's default dataset. Use this when chaining multiple discovery actors into one shared dataset. ## `runId` (type: `string`): Optional external or Apify run ID copied into each output row and RUN\_SUMMARY. Use this to trace listings back to a parent workflow run. ## Actor input object example ```json { "location": "New York, NY", "operation": "sale", "propertyType": "apartment", "maxItems": 3 } ``` # Actor output Schema ## `dataset` (type: `string`): No description # 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 = { "location": "New York, NY" }; // Run the Actor and wait for it to finish const run = await client.actor("trovevault/redfin-property-discovery-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 = { "location": "New York, NY" } # Run the Actor and wait for it to finish run = client.actor("trovevault/redfin-property-discovery-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 '{ "location": "New York, NY" }' | apify call trovevault/redfin-property-discovery-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=trovevault/redfin-property-discovery-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Redfin Property Discovery Scraper", "description": "Discover public Redfin sale listings by location and property type. Extract descriptions, prices, areas, rooms, features, images, brokers, and URLs.", "version": "0.1", "x-build-id": "9bFSaI0qQYYfhxXaU" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/trovevault~redfin-property-discovery-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-trovevault-redfin-property-discovery-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/trovevault~redfin-property-discovery-scraper/runs": { "post": { "operationId": "runs-sync-trovevault-redfin-property-discovery-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/trovevault~redfin-property-discovery-scraper/run-sync": { "post": { "operationId": "run-sync-trovevault-redfin-property-discovery-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": [ "location", "operation", "propertyType" ], "properties": { "location": { "title": "Location", "type": "string", "description": "Major US city or ZIP code to search. Use English names, for example New York, NY; Los Angeles, CA; Chicago, IL; Dallas, TX; Austin, TX; Seattle, WA; or 10001. City-level searches are usually more precise and stable than broad regions.", "default": "New York, NY" }, "operation": { "title": "Operation", "enum": [ "sale" ], "type": "string", "description": "Sale listings are supported in this version. Redfin rental pages currently require an AWS WAF browser flow and are not enabled.", "default": "sale" }, "propertyType": { "title": "Property Type", "enum": [ "any", "apartment", "house", "land", "commercial" ], "type": "string", "description": "Choose the type of property to discover. Use Any to return the broadest listing set supported by Redfin.", "default": "apartment" }, "maxItems": { "title": "Maximum Items", "minimum": 1, "maximum": 1000, "type": "integer", "description": "Maximum number of property listings to return. Use smaller values for quick checks and higher values for broader market discovery.", "default": 3 }, "datasetId": { "title": "Dataset ID", "type": "string", "description": "Optional Apify dataset ID to append each saved listing to, in addition to this run's default dataset. Use this when chaining multiple discovery actors into one shared dataset." }, "runId": { "title": "Run ID", "type": "string", "description": "Optional external or Apify run ID copied into each output row and RUN_SUMMARY. Use this to trace listings back to a parent workflow run." } } }, "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 } } } } } } } } } } ```