# Streeteasy Review Scraper (`getdataforme/streeteasy-review-scraper`)

The Streeteasy Review Scraper extracts real estate listings from StreetEasy based on city, price range, and property type. Returns structured JSON data with title, address, price, beds, baths, area, URL, and image. Ideal for market analysis, research, or business intelligence

- **URL**: https://beta-securitybyobscurity.apify.com/getdataforme/streeteasy-review-scraper.md
- **Developed by:** [GetDataForMe](https://beta-securitybyobscurity.apify.com/getdataforme) (community)
- **Categories:** E-commerce, AI, Automation
- **Stats:** 2 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

$35.00/month + usage

To use this Actor, you pay a monthly rental fee to the developer. The rent is subtracted from your prepaid usage every month after the free trial period.
You also pay for the Apify platform usage, which gets cheaper the higher Apify subscription plan you have.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#rental-actors

# README

### Streeteasy Review Scraper

### Introduction

The **Streeteasy Review Scraper** is an Apify Actor designed to scrape real estate listings from StreetEasy, a popular platform for property sales and rentals. This Actor retrieves detailed property information based on user-defined criteria such as city, price range, and property type. It is perfect for users who need structured data on real estate listings for analysis, research, or business purposes.

### Input Parameters

The Actor accepts the following input parameters to customize the scraping process:

| Parameter            | Type   | Description                                                                 | Required | Default Value |
|----------------------|--------|-----------------------------------------------------------------------------|----------|---------------|
| `City`               | String | The city to search for listings (e.g., "nyc").                               | Yes      | -             |
| `PriceMax`           | String | Maximum price for the listings (e.g., "150000000").                          | Yes      | -             |
| `PriceMin`           | String | Minimum price for the listings (e.g., "500").                                | Yes      | -             |
| `PropertyType`       | String | Type of property (e.g., "for-sale").                                        | Yes      | -             |
| `proxyConfiguration` | Object | Proxy settings for the scraper. Must include `useApifyProxy` and optionally `apifyProxyGroups`. | Yes      | -             |

#### Example Input

```json
{
  "City": "nyc",
  "PriceMax": "150000000",
  "PriceMin": "500",
  "PropertyType": "for-sale",
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

### Features

- **Customizable Search**: Filter listings by city, price range, and property type to target specific real estate data.
- **Structured Output**: Returns detailed property information in JSON format, including title, address, price, beds, baths, area, URL, and image.
- **Reliable Proxy Support**: Utilizes Apify's proxy configuration to ensure stable and anonymous scraping.
- **Scalable and Efficient**: Built to handle large-scale scraping tasks with optimized performance.

### Output

The Actor outputs a JSON array of property listings with the following fields:

| Field       | Description                                      |
|-------------|--------------------------------------------------|
| `title`     | Type of property (e.g., "Condo").                |
| `address`   | Full address of the property.                    |
| `price`     | Listed price of the property.                    |
| `beds`      | Number of bedrooms (e.g., "1 bed").              |
| `baths`     | Number of bathrooms (e.g., "1 bath").            |
| `area_sqft` | Area of the property in square feet.             |
| `url`       | URL to the property listing on StreetEasy.       |
| `image`     | URL to the property's main image.                |

#### Example Output

```json
[
  {
    "title": "Condo",
    "address": "425 Main Street #14A",
    "price": "$920,000",
    "beds": "1 bed",
    "baths": "1 bath",
    "area_sqft": "ft²",
    "url": "https://streeteasy.com/building/riverwalk-landing/14a?featured=1",
    "image": "https://photos.zillowstatic.com/fp/f47043960cba4efc92e07714b2b337cb-p_e.webp"
  },
  {
    "title": "Condo",
    "address": "255 East 77th Street #29B",
    "price": "$8,600,000",
    "beds": "4 beds",
    "baths": "4.5 baths",
    "area_sqft": "ft²",
    "url": "https://streeteasy.com/building/255-east-77/29b?featured=1",
    "image": "https://photos.zillowstatic.com/fp/5e78bf004ca7a62cae1a15a058f3c299-p_e.webp"
  }
]
```

### Use Cases

- **Real Estate Analysis**: Gather data for market trends, price comparisons, or investment opportunities.
- **Property Research**: Collect detailed property information for academic or personal research.
- **Business Intelligence**: Integrate listing data into real estate platforms or apps for enhanced user experiences.
- **Competitor Monitoring**: Track listings to analyze competitors’ offerings in specific markets.

### Support

For bug reports or custom needs, contact us at **support@getdataforme.com** or use our contact form: <https://getdataforme.com/contact/>.\
Please include a clear subject line in your message, such as "Streeteasy Review Scraper Support" or "Custom Request". Thank you!

# Actor input Schema

## `PropertyType` (type: `string`):

The property type for the spider.

## `City` (type: `string`):

The city for the spider.

## `PriceMin` (type: `string`):

The price min for the spider.

## `PriceMax` (type: `string`):

The price max for the spider.

## `itemLimit` (type: `integer`):

Specifies the maximum number of items to process.

## `proxyConfiguration` (type: `object`):

Specifies proxy servers that will be used by the scraper in order to hide its origin.

## Actor input object example

```json
{
  "PropertyType": "for-sale",
  "City": "nyc",
  "PriceMin": "500",
  "PriceMax": "150000000",
  "itemLimit": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "itemLimit": 10,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("getdataforme/streeteasy-review-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "itemLimit": 10,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("getdataforme/streeteasy-review-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 '{
  "itemLimit": 10,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call getdataforme/streeteasy-review-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=getdataforme/streeteasy-review-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Streeteasy Review Scraper",
        "description": "The Streeteasy Review Scraper extracts real estate listings from StreetEasy based on city, price range, and property type. Returns structured JSON data with title, address, price, beds, baths, area, URL, and image. Ideal for market analysis, research, or business intelligence",
        "version": "0.0",
        "x-build-id": "mgo5iXyrtyrtC388P"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/getdataforme~streeteasy-review-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-getdataforme-streeteasy-review-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/getdataforme~streeteasy-review-scraper/runs": {
            "post": {
                "operationId": "runs-sync-getdataforme-streeteasy-review-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/getdataforme~streeteasy-review-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-getdataforme-streeteasy-review-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": {
                    "PropertyType": {
                        "title": "Property Type",
                        "type": "string",
                        "description": "The property type for the spider.",
                        "default": "for-sale"
                    },
                    "City": {
                        "title": "City",
                        "type": "string",
                        "description": "The city for the spider.",
                        "default": "nyc"
                    },
                    "PriceMin": {
                        "title": "Price Min",
                        "type": "string",
                        "description": "The price min for the spider.",
                        "default": "500"
                    },
                    "PriceMax": {
                        "title": "Price Max",
                        "type": "string",
                        "description": "The price max for the spider.",
                        "default": "150000000"
                    },
                    "itemLimit": {
                        "title": "Item Limit",
                        "type": "integer",
                        "description": "Specifies the maximum number of items to process."
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Specifies proxy servers that will be used by the scraper in order to hide its origin.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ]
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
