# Redfin Search Scraper (`tri_angle/redfin-search`) Actor
Scrape real estate properties in given area from Redfin.com fast and easily
- **URL**: https://apify.com/tri\_angle/redfin-search.md
- **Developed by:** [Triβangle](https://apify.com/tri_angle) (Apify)
- **Categories:** Real estate
- **Stats:** 545 total users, 55 monthly users, 97.6% runs succeeded, 20 bookmarks
- **User rating**: 3.59 out of 5 stars
## Pricing
Pay per event
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.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
### What can Redfin Search Scraper do?
This scraper lets you get list of real estate properties in given area from Redfin fast and easily. It's suitable for
such use cases as scraping homes for sale, for rent or recently sold on the Redfin platform. For each home, this scraper
provides basic information such as price, size, street address, number of bedrooms and bathrooms.
### Is it legal to scrape Redfin?
It is legal to scrape publicly available data such as property prices, availability, or street address. Read our blog
post on [the legality of web scraping](https://blog.apify.com/is-web-scraping-legal/) to learn more.
### How much does Redfin Search Scraper cost?
This scraper uses the Pay-per-result pricing model, so your costs can be easily calculated: It will cost you $1 to
scrape 1,000 search results, so 0.001 USD per item. It is possible to limit the number of output items in input
configuration, under the last Options section.
Apify provides you with USD 5 free usage credits every month on the Apify Free plan, so you can get 5,000 results from
Redfin completely for free!
But if you need to get more data or to get your data regularly, you should grab an Apify subscription. We recommend
our $49/month Starter plan - you could get up to 50k Redfin results every month with the $49 monthly plan!
### How many results can I get from Redfin search? Am I limited to 9 pages of results like on the website?
No, this limitation doesn't apply to the scraper. Unless you explicitely disable the _Zoom in to scrape more items_ flag
in the input, this Actor will use a smart technique to extract all results for your selected area. Which brings us to
the next question,
### What does the _Zoom in to scrape more items_ flag do?
This flag enables a powerful technique that allows the scraper to extract all results for a given area, overcoming the
maximum limit of 9 pages of results for searches in large areas.
How it works: The scraper loads the map for a given area. It returns the results, and checks the total number of pages
available. If there are 9 pages (= the maximum that Redfin offers), it splits the map in 4 parts, and repeats the
process with increased zoom for each of them, until it reaches a zoom level where it is certain that zooming closer
won't uncover more results.
A big advantage of this approach is that you aren't wasting money on scraping both dense areas and areas with few
results at the same zoom level - the scraper only zooms in if it needs to do so in order to get complete results. Using
this method, it is possible to scrape over 600 thousand results from a single search!
This mechanism is enabled by default
### How do I use Redfin Search Scraper?
Redfin Search Scraper provides a simple and straightforward way to extract real estate property data from Redfin. Here
are the basic steps to use Redfin Search Scraper:
1. Input Configuration: Provide URLs to search pages that you want to scrape. Note that these URLs must point to pages
which show a map of results.
2. Run Scraper: Start the scraping process by running Redfin Search Scraper.
3. Retrieve Results: Once the scraping is complete, you can retrieve the results in a structured format, such as JSON,
CSV, or Excel, and use the data for your desired purposes.
### Input
When running Redfin Search Scraper, you need to configure which URLs what you want to scrape and optionally additional
scraping filters. This input is provided either as a JSON file or in the editor on the Apify platform
For detailed descriptions and examples for all input fields, please visit the
dedicated [Input page](https://apify.com/tri_angle/redfin-search/input-schema).
### Sample output from Redfin Search Scraper
#### Properties for sale
```json
{
"mlsId": {
"label": "Listing #",
"value": "95926"
},
"showMlsId": false,
"mlsStatus": "Coming Soon",
"showDatasourceLogo": false,
"price": {
"value": 425000,
"level": 1
},
"hideSalePrice": false,
"hoa": {
"level": 1
},
"isHoaFrequencyKnown": true,
"sqFt": {
"value": 2139,
"level": 1
},
"pricePerSqFt": {
"value": 199,
"level": 1
},
"lotSize": {
"value": 23086,
"level": 1
},
"beds": 5,
"baths": 2.5,
"location": {
"value": "Meridianville",
"level": 1
},
"latLong": {
"value": {
"latitude": 34.8533551,
"longitude": -86.5461225
},
"level": 1
},
"streetLine": {
"value": "172 Wes Ashley Dr",
"level": 1
},
"unitNumber": {
"level": 1
},
"city": "Meridianville",
"state": "AL",
"zip": "35759",
"postalCode": {
"value": "35759",
"level": 1
},
"countryCode": "US",
"showAddressOnMap": true,
"soldDate": 1683874800000,
"searchStatus": 8,
"propertyType": 6,
"uiPropertyType": 1,
"listingType": 6,
"propertyId": 125891238,
"listingId": 180102965,
"dataSourceId": 223,
"marketId": 48,
"yearBuilt": {
"value": 2009,
"level": 1
},
"dom": {
"value": 2,
"level": 1
},
"timeOnRedfin": {
"value": 155446534,
"level": 1
},
"timeZone": "US/Central",
"primaryPhotoDisplayLevel": 1,
"photos": {
"level": 1
},
"alternatePhotosInfo": {
"mediaListType": "1",
"mediaListIndex": 0,
"groupCode": "877061_JPG",
"positionSpec": [
35, 34, 24, 23, 7, 5, 6, 37, 38, 39, 36, 40, 11, 12, 10, 9, 8, 13, 41, 42, 43, 47, 44, 45, 46, 14, 15, 18, 19, 16, 17, 26, 29,
20, 21, 28, 25, 27, 22, 3, 2, 4
],
"type": 1
},
"additionalPhotosInfo": [],
"listingAgent": {
"name": "Jeremy Nichols",
"redfinAgentId": 16682
},
"url": "https://www.redfin.com/AL/Meridianville/172-Wes-Ashley-Dr-35759/home/125891238",
"hasInsight": false,
"sashes": [
{
"sashType": 20,
"sashTypeId": 20,
"sashTypeName": "Coming Soon",
"sashTypeColor": "#2E7E36",
"isRedfin": true,
"openHouseText": "",
"lastSaleDate": "",
"lastSalePrice": ""
}
],
"isHot": false,
"hasVirtualTour": false,
"hasVideoTour": false,
"has3DTour": false,
"newConstructionCommunityInfo": {},
"isRedfin": true,
"isNewConstruction": false,
"listingRemarks": "Coming Soon!",
"remarksAccessLevel": 1,
"servicePolicyId": 33,
"businessMarketId": 71,
"isShortlisted": false,
"isViewedListing": false,
"offerType": "sale",
"resultIndex": 1,
"foundFromSearchUrl": "https://www.redfin.com/zipcode/32754/filter/viewport=42.04234:29.15358:-76.64759:-100.04847,no-outline",
"zoomQuadrantSequence": []
}
````
#### Properties for rent
```json
{
"propertyId": "186342666",
"url": "https://www.redfin.com/NY/Jamaica/Ruby-Square/apartment/186342666",
"propertyType": 5,
"photosInfo": {
"photoRanges": [
{
"startPos": 0,
"endPos": 10,
"version": "2"
},
{
"startPos": 11,
"endPos": 15,
"version": "4"
},
{
"startPos": 16,
"endPos": 16,
"version": "3"
},
{
"startPos": 17,
"endPos": 17,
"version": "4"
},
{
"startPos": 18,
"endPos": 18,
"version": "3"
},
{
"startPos": 19,
"endPos": 19,
"version": "4"
},
{
"startPos": 20,
"endPos": 29,
"version": "3"
},
{
"startPos": 30,
"endPos": 38,
"version": "2"
}
]
},
"sashes": [
{
"sashTypeId": 7,
"sashTypeName": "New",
"sashTypeColor": "#2E7E36",
"timeOnRedfin": "170969267"
}
],
"staticMapUrl": "https://maps.google.com/maps/api/staticmap?sensor=false&style=feature%3Aadministrative.land_parcel%7Cvisibility%3Aoff&style=feature%3Alandscape.man_made%7Cvisibility%3Aoff&style=feature%3Atransit.station%7Chue%3A0xffa200¢er=40.7073053%2C-73.7943703&channel=seekers-search_map&size=574x430&format=jpg&scale=2&zoom=11&client=gme-redfin&signature=fSc7Jd-zJ0XP2aJIbf953Uy_9IU=",
"hasAttFiber": false,
"addressInfo": {
"centroid": {
"centroid": {
"latitude": 40.7073053,
"longitude": -73.7943703
}
},
"formattedStreetLine": "16620 90th Ave",
"city": "Jamaica",
"state": "NY",
"zip": "11432",
"streetlineDisplayLevel": 1,
"unitNumberDisplayLevel": 1,
"locationDisplayLevel": 1,
"countryCode": 1,
"postalCodeDisplayLevel": 1
},
"rentalId": "72183d58-2c50-4cab-b9d1-ed6998bdf04f",
"bedRange": {
"min": 0,
"max": 2
},
"bathRange": {
"min": 1,
"max": 2
},
"sqftRange": {
"min": 10,
"max": 10
},
"rentPriceRange": {
"min": 2850,
"max": 3995
},
"lastUpdated": "2025-07-08T14:51:23.454465Z",
"numAvailableUnits": 23,
"status": 1,
"propertyName": "Ruby Square",
"rentalDetailsPageType": 6,
"searchRankScore": 1,
"freshnessTimestamp": "2025-07-08T12:51:37.072Z",
"description": "Introducing Ruby Square, a new urban oasis conveniently located in Queens. Envisioned to be a haven from the hustle of the city, Ruby Square offers residents a one-of-a-kind living experience and visi",
"revenuePerLead": 11,
"feedSourceInternalId": "lc6020841",
"isCommercialPaid": true,
"feedOriginalSource": "ZILLOW",
"desktopPhone": "6465163223",
"mobileWebPhone": "6465163223",
"mobileAppPhone": "6465163223",
"keyFacts": [
{
"description": "29 units available",
"rank": 0
},
{
"description": "Dishwasher",
"rank": 6
},
{
"description": "Walker's paradise",
"rank": 8
}
],
"feedSource": "RentPath",
"units": [
{
"bedrooms": 0,
"rentPrice": 2850
},
{
"bedrooms": 1,
"rentPrice": 2855
},
{
"bedrooms": 2,
"rentPrice": 3595
}
],
"feedExternalId": "zuwtnkjc1q27",
"leadRequiresMoveInDate": true,
"paidPhone": "6465161434",
"offerType": "rent",
"resultIndex": 1,
"foundFromSearchUrl": "https://www.redfin.com/city/30749/NY/New-York/rentals/filter/viewport=41.179:40.45514:-73.69918:-74.22446",
"zoomQuadrantSequence": []
}
```
*Note that we can't guarantee 100% stability of this output, since Redfin can change availability of individual fields
in search results.*
### Integrations and Redfin Search Scraper
Last but not least, Redfin Search Scraper can be connected with almost any cloud service or web app thanks
to integrations on the Apify platform. You can integrate
with Make, Zapier, Slack, Airbyte, GitHub, Google Sheets, Google
Drive, and more. Or you can
use webhooks to carry out an action
whenever an event occurs, e.g. get a notification whenever Redfin Search Scraper successfully finishes a run.
### Using Redfin Search Scraper with the Apify API
The Apify API gives you programmatic access to the Apify platform. The API is organized around RESTful HTTP endpoints
that enable you to manage, schedule, and run Apify actors. The API also lets you access any datasets, monitor actor
performance, fetch results, create and update versions, and more.
To access the API using Node.js, use the apify-client NPM package. To access the API using Python, use the apify-client
PyPI package.
Check out the Apify API reference docs for full details or
click on the API tab for code examples.
# Actor input Schema
## `searchUrls` (type: `array`):
URLs of your map search queries.
## `zoomIn` (type: `boolean`):
If the Actor detects that not all results available in area were returned, it will split the map into smaller areas and retry the request. See Actor's README for more details.
## `maxResults` (type: `integer`):
Limit the number of results scraped. If not specified, there is no limit.
## `debugLog` (type: `boolean`):
Enable debug logging
## Actor input object example
```json
{
"searchUrls": [
{
"url": "https://www.redfin.com/zipcode/32754/filter/viewport=28.61051:28.50029:-81.21071:-81.41155,no-outline"
}
],
"zoomIn": true,
"debugLog": false
}
```
# 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 = {
"searchUrls": [
{
"url": "https://www.redfin.com/zipcode/32754/filter/viewport=28.61051:28.50029:-81.21071:-81.41155,no-outline"
}
]
};
// Run the Actor and wait for it to finish
const run = await client.actor("tri_angle/redfin-search").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 = { "searchUrls": [{ "url": "https://www.redfin.com/zipcode/32754/filter/viewport=28.61051:28.50029:-81.21071:-81.41155,no-outline" }] }
# Run the Actor and wait for it to finish
run = client.actor("tri_angle/redfin-search").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 '{
"searchUrls": [
{
"url": "https://www.redfin.com/zipcode/32754/filter/viewport=28.61051:28.50029:-81.21071:-81.41155,no-outline"
}
]
}' |
apify call tri_angle/redfin-search --silent --output-dataset
```
## MCP server setup
```json
{
"mcpServers": {
"apify": {
"command": "npx",
"args": [
"mcp-remote",
"https://mcp.apify.com/?tools=tri_angle/redfin-search",
"--header",
"Authorization: Bearer "
]
}
}
}
```
## OpenAPI specification
```json
{
"openapi": "3.0.1",
"info": {
"title": "Redfin Search Scraper",
"description": "Scrape real estate properties in given area from Redfin.com fast and easily",
"version": "0.0",
"x-build-id": "oYB2dwl5cs6fR2HXv"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/tri_angle~redfin-search/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-tri_angle-redfin-search",
"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/tri_angle~redfin-search/runs": {
"post": {
"operationId": "runs-sync-tri_angle-redfin-search",
"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/tri_angle~redfin-search/run-sync": {
"post": {
"operationId": "run-sync-tri_angle-redfin-search",
"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": {
"searchUrls": {
"title": "Redfin Search URLs",
"type": "array",
"description": "URLs of your map search queries.",
"items": {
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"title": "URL of a web page",
"format": "uri"
}
}
}
},
"zoomIn": {
"title": "Zoom in to scrape more items",
"type": "boolean",
"description": "If the Actor detects that not all results available in area were returned, it will split the map into smaller areas and retry the request. See Actor's README for more details.",
"default": true
},
"maxResults": {
"title": "Max number of results",
"type": "integer",
"description": "Limit the number of results scraped. If not specified, there is no limit."
},
"debugLog": {
"title": "Debug Log",
"type": "boolean",
"description": "Enable debug logging",
"default": 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
}
}
},
"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
}
}
}
}
}
}
}
}
}
}
```