# StreetEasy $1💰 URL Search | Keyword Filtering | Rich Output (`abotapi/streeteasy-scraper`) Actor

From $1/1K. Scrape streeteasy.com across NYC and Jersey City for sales, rentals, in-contract, and sold properties. Supports filters or direct URLs. Returns pricing, coordinates, photos, brokerage, amenities, building details, agent contacts, and price history.

- **URL**: https://apify.com/abotapi/streeteasy-scraper.md
- **Developed by:** [AbotAPI](https://apify.com/abotapi) (community)
- **Categories:** Real estate, Automation, Developer tools
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

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

## StreetEasy NYC Scraper

Pull complete NYC and Jersey City listings from StreetEasy: for-sale, for-rent, in-contract, and recently sold. Combine filters (areas, price, beds, baths, sqft, amenities, sort) into a single search, or paste any StreetEasy URL and let the actor walk pagination forward. Returns 30+ fields per listing including coordinates, neighborhood, brokerage, photos, and optional detail-page enrichment for amenities, building info, agent contact, and price history.

### Why This Scraper?

- Structured filter mode covering price, beds, baths, sqft, amenities, sort, and 5 listing categories (sale, rent, in contract, sold, off market).
- Returns up to 500 listings per page, so a 100-result run completes in seconds.
- Coordinates (latitude / longitude) on every record without needing detail enrichment.
- Auto-expand mode splits queries above ~1,050 results into price buckets so you can extract the full market.
- URL mode accepts any sale, rent, sold, building, or filtered StreetEasy URL.
- Pay-per-result pricing: low base rate; detail enrichment surcharge fires only when you turn it on, only for records that actually returned detail.
- All five NYC boroughs plus Jersey City, Hoboken, and surrounding NJ areas.

### Data You Get

> Sample shape, values are illustrative placeholders, not from a live listing.

| Field            | Example                                              |
| ---------------- | ---------------------------------------------------- |
| id               | `0000001`                                            |
| url              | `https://streeteasy.com/building/sample-tower/4a`    |
| saleType         | `forSale`                                            |
| status           | `For sale`                                           |
| price            | `1250000`                                            |
| neighborhood     | `Sample Neighborhood`                                |
| borough          | `Manhattan`                                          |
| address          | `100 Sample Street`                                  |
| unit             | `4A`                                                 |
| bedrooms         | `2`                                                  |
| bathrooms        | `2`                                                  |
| halfBathrooms    | `0`                                                  |
| squareFeet       | `1100`                                               |
| pricePerSqft     | `1136.36`                                            |
| propertyType     | `Condo`                                              |
| latitude         | `40.7000`                                            |
| longitude        | `-74.0000`                                           |
| imageUrl         | `https://photos.zillowstatic.com/fp/0-uncropped.webp`|
| brokerage        | `Sample Realty`                                      |
| listedAt         | `2026-01-01`                                         |
| daysOnMarket     | `30`                                                 |
| advertisedListing| `false`                                              |
| description      | (when fetchDetails = true) Full listing description  |
| amenities        | `["Doorman", "Elevator", "Gym"]`                     |
| buildingName     | `Sample Tower`                                       |
| buildingYear     | `1990`                                               |
| schoolDistricts  | `["1"]`                                              |
| transit          | `["6", "Q"]`                                         |
| priceHistory     | `[{date,event,price}, ...]`                          |
| agents           | `[{name,phone,brokerage}, ...]`                      |
| openHouseDates   | `["2026-02-01"]`                                     |

### How to Use

Search mode, single borough:

```json
{
  "mode": "search",
  "saleType": "forSale",
  "locations": ["manhattan"],
  "minPrice": 1000000,
  "maxPrice": 2000000,
  "minBedrooms": 2,
  "amenities": ["DOORMAN", "ELEVATOR"],
  "sortBy": "PRICE_ASC",
  "maxPages": 5,
  "maxListings": 200
}
````

Search mode, multi-borough rentals:

```json
{
  "mode": "search",
  "saleType": "forRent",
  "locations": ["brooklyn", "queens"],
  "maxPrice": 4000,
  "noFee": true,
  "minBedrooms": 1,
  "sortBy": "LISTED_AT_DESC",
  "maxListings": 100
}
```

URL mode, multi-URL:

```json
{
  "mode": "url",
  "urls": [
    "https://streeteasy.com/for-sale/williamsburg",
    "https://streeteasy.com/for-rent/upper-east-side?page=2",
    "https://streeteasy.com/sold/manhattan"
  ],
  "maxPages": 3,
  "perPage": 200
}
```

Detail enrichment (slower, full agent + amenity coverage):

```json
{
  "mode": "search",
  "saleType": "forSale",
  "locations": ["dumbo"],
  "fetchDetails": true,
  "maxListings": 25
}
```

### Input Parameters

| Parameter           | Type      | Default            | Description                                                                  |
| ------------------- | --------- | ------------------ | ---------------------------------------------------------------------------- |
| mode                | enum      | `search`           | `search` (filters) or `url` (paste URLs).                                    |
| saleType            | enum      | `forSale`          | `forSale`, `forRent`, `inContract`, `recentlySold`, `offMarket`.             |
| locations           | string\[]  | `["nyc"]`          | Slugs (manhattan, brooklyn, williamsburg, jersey-city, ...) or numeric IDs.  |
| propertyTypes       | enum\[]    | `[]`               | CONDO, CO\_OP, HOUSE, TOWNHOUSE, MULTI\_FAMILY, RENTAL, CONDOP.                |
| minPrice / maxPrice | integer   | none               | Price range in USD.                                                          |
| minBedrooms         | integer   | none               | Use 0 for studios.                                                           |
| maxBedrooms         | integer   | none               |                                                                              |
| minBathrooms        | number    | none               | Decimal supported (1.5).                                                     |
| minSqft / maxSqft   | integer   | none               | Living area in square feet.                                                  |
| amenities           | enum\[]    | `[]`               | Listings must include all selected amenities.                                |
| noFee               | boolean   | `false`            | Rentals only: filter to no-broker-fee listings.                              |
| keywords            | string    | none               | Free-text search inside the description / title.                             |
| sortBy              | enum      | `RECOMMENDED`      | RECOMMENDED, PRICE\_ASC/DESC, LISTED\_AT\_ASC/DESC, SQFT\_DESC, BEDROOMS\_DESC.   |
| urls                | string\[]  | `[]`               | URL mode only.                                                               |
| maxPages            | integer   | `0` (unlimited)    | Pagination cap per query (0 to 50). 0 means walk all pages until exhausted.  |
| perPage             | integer   | `100`              | Listings per page (10 to 500).                                               |
| maxListings         | integer   | `20`               | Hard cap across the whole run, 0 means unlimited. Bump for production scrapes. |
| fetchDetails        | boolean   | `false`            | Enrich each record with detail page fields. Adds 1 HTTP request per record.  |
| expandLargeQueries  | boolean   | `false`            | Auto-shard queries above 1,050 results into price buckets and merge.         |
| proxy               | object    | Apify Residential US| Country forced to US.                                                       |

### Output Example

> Sample shape, values are illustrative placeholders.

```json
{
  "id": "0000001",
  "url": "https://streeteasy.com/building/sample-tower/4a",
  "saleType": "forSale",
  "status": "For sale",
  "price": 1250000,
  "neighborhood": "Sample Neighborhood",
  "borough": "Manhattan",
  "address": "100 Sample Street",
  "unit": "4A",
  "bedrooms": 2,
  "bathrooms": 2,
  "halfBathrooms": 0,
  "squareFeet": 1100,
  "pricePerSqft": 1136.36,
  "propertyType": "Condo",
  "latitude": 40.7000,
  "longitude": -74.0000,
  "imageUrl": "https://photos.zillowstatic.com/fp/0-uncropped.webp",
  "images": ["https://photos.zillowstatic.com/fp/0-uncropped.webp"],
  "brokerage": "Sample Realty",
  "listedAt": "2026-01-01",
  "daysOnMarket": 30,
  "offMarketAt": null,
  "furnished": false,
  "noFee": null,
  "advertisedListing": false,
  "description": "Full seller description text appears here when fetchDetails = true.",
  "amenities": ["Doorman", "Elevator", "Gym"],
  "buildingName": "Sample Tower",
  "buildingYear": 1990,
  "schoolDistricts": ["1"],
  "transit": ["6", "Q"],
  "priceHistory": [{ "date": "2026-01-01", "event": "Listed", "price": 1250000 }],
  "agents": [{ "name": "Agent Name", "phone": "+10000000000", "brokerage": "Sample Realty" }],
  "openHouseDates": ["2026-02-01"],
  "virtualTourUrl": null,
  "sourceUrl": null
}
```

### Plan Requirement

This actor requires Apify Residential proxy with country US. StreetEasy blocks datacenter ranges, so the default Apify proxy (datacenter) will return 0 results.

- Free plan: does not include Residential proxy. Upgrade to Starter or higher.
- Starter plan and above: includes Residential proxy access.
- The actor automatically pins country to US even if you forget to select it.

If you run on Free plan with the default proxy, you will see a prominent warning at the start of the run and an empty dataset. Upgrade and re-run.

# Actor input Schema

## `mode` (type: `string`):

Use search mode to combine filters (areas, price, beds, baths, etc.) into one query. Use url mode to paste one or more StreetEasy URLs (sale, rent, sold, in-contract) and let the actor walk pagination forward.

## `saleType` (type: `string`):

Sale, rental, recently sold, in contract, or off market.

## `locations` (type: `array`):

Slugs as they appear in StreetEasy URLs. Examples: nyc (all NYC), manhattan, brooklyn, queens, bronx, staten-island, williamsburg, astoria, jersey-city, hoboken, upper-east-side, park-slope, dumbo. Multi-select supported. Defaults to all NYC.

## `propertyTypes` (type: `array`):

Filter by building / property type. Multi-select supported.

## `minPrice` (type: `integer`):

Lower bound on price. For sales: total price. For rentals: monthly rent.

## `maxPrice` (type: `integer`):

Upper bound on price. For sales: total price. For rentals: monthly rent.

## `minBedrooms` (type: `integer`):

Use 0 for studios.

## `maxBedrooms` (type: `integer`):

Upper bound on bedroom count.

## `minBathrooms` (type: `number`):

Lower bound on bathroom count. Decimal supported (1.5).

## `minSqft` (type: `integer`):

Lower bound on living area (square feet).

## `maxSqft` (type: `integer`):

Upper bound on living area (square feet).

## `amenities` (type: `array`):

Filter to listings that advertise these amenities.

## `noFee` (type: `boolean`):

Rentals: only listings with no broker fee. Ignored when saleType is not forRent.

## `keywords` (type: `string`):

Free-text keyword filter (matches description / title).

## `sortBy` (type: `string`):

Order in which results are returned.

## `urls` (type: `array`):

Examples:
• https://streeteasy.com/for-sale/manhattan
• https://streeteasy.com/for-rent/williamsburg/price:3000-5000
• https://streeteasy.com/sold/nyc
• https://streeteasy.com/building/the-lombardy/1401
Multi-URL supported. Filter-mode fields are ignored. Pagination starts at the URL's page and walks forward.

## `maxPages` (type: `integer`):

Pagination cap per query. Each page returns up to perPage listings (default 100). 0 = walk all pages until exhausted, bounded only by maxListings.

## `perPage` (type: `integer`):

Up to 500 supported. Higher values mean fewer round trips and lower cost.

## `maxListings` (type: `integer`):

Hard cap across the whole run. The actor stops as soon as this many records have been pushed. Default 20 keeps small test runs cheap; bump it for production scrapes.

## `fetchDetails` (type: `boolean`):

When on, the actor opens each listing page to enrich amenities, building info, agent contact, full description, and price history. Adds one HTTP request per listing.

## `expandLargeQueries` (type: `boolean`):

When on and a query matches more than the per-query cap (~1050), the actor splits it into price buckets and merges results so you can extract the full market.

## `proxy` (type: `object`):

Apify Residential US is required (StreetEasy blocks datacenter ranges). Country is forced to US.

## Actor input object example

```json
{
  "mode": "search",
  "saleType": "forSale",
  "locations": [
    "nyc"
  ],
  "propertyTypes": [],
  "amenities": [],
  "noFee": false,
  "sortBy": "RECOMMENDED",
  "urls": [
    "https://streeteasy.com/for-sale/williamsburg"
  ],
  "maxPages": 0,
  "perPage": 100,
  "maxListings": 20,
  "fetchDetails": false,
  "expandLargeQueries": false,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}
```

# Actor output Schema

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

// Prepare Actor input
const input = {
    "locations": [
        "nyc"
    ],
    "urls": [
        "https://streeteasy.com/for-sale/williamsburg"
    ],
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/streeteasy-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 = {
    "locations": ["nyc"],
    "urls": ["https://streeteasy.com/for-sale/williamsburg"],
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/streeteasy-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 '{
  "locations": [
    "nyc"
  ],
  "urls": [
    "https://streeteasy.com/for-sale/williamsburg"
  ],
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "US"
  }
}' |
apify call abotapi/streeteasy-scraper --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "StreetEasy $1💰 URL Search | Keyword Filtering | Rich Output",
        "description": "From $1/1K. Scrape streeteasy.com across NYC and Jersey City for sales, rentals, in-contract, and sold properties. Supports filters or direct URLs. Returns pricing, coordinates, photos, brokerage, amenities, building details, agent contacts, and price history.",
        "version": "1.1",
        "x-build-id": "MuWYNeTrhnghkbXNu"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/abotapi~streeteasy-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-abotapi-streeteasy-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/abotapi~streeteasy-scraper/runs": {
            "post": {
                "operationId": "runs-sync-abotapi-streeteasy-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/abotapi~streeteasy-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-abotapi-streeteasy-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": [
                    "mode"
                ],
                "properties": {
                    "mode": {
                        "title": "🎯 Start here, pick your search mode",
                        "enum": [
                            "search",
                            "url"
                        ],
                        "type": "string",
                        "description": "Use search mode to combine filters (areas, price, beds, baths, etc.) into one query. Use url mode to paste one or more StreetEasy URLs (sale, rent, sold, in-contract) and let the actor walk pagination forward.",
                        "default": "search"
                    },
                    "saleType": {
                        "title": "Listing type",
                        "enum": [
                            "forSale",
                            "forRent",
                            "inContract"
                        ],
                        "type": "string",
                        "description": "Sale, rental, recently sold, in contract, or off market.",
                        "default": "forSale"
                    },
                    "locations": {
                        "title": "Locations (boroughs / neighborhoods)",
                        "type": "array",
                        "description": "Slugs as they appear in StreetEasy URLs. Examples: nyc (all NYC), manhattan, brooklyn, queens, bronx, staten-island, williamsburg, astoria, jersey-city, hoboken, upper-east-side, park-slope, dumbo. Multi-select supported. Defaults to all NYC.",
                        "items": {
                            "type": "string"
                        },
                        "default": [
                            "nyc"
                        ]
                    },
                    "propertyTypes": {
                        "title": "Property types",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter by building / property type. Multi-select supported.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "CONDO",
                                "CO_OP",
                                "HOUSE",
                                "TOWNHOUSE",
                                "MULTI_FAMILY",
                                "RENTAL",
                                "CONDOP"
                            ],
                            "enumTitles": [
                                "Condo",
                                "Co-op",
                                "House",
                                "Townhouse",
                                "Multi-family",
                                "Rental",
                                "Condop"
                            ]
                        },
                        "default": []
                    },
                    "minPrice": {
                        "title": "Min price (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Lower bound on price. For sales: total price. For rentals: monthly rent."
                    },
                    "maxPrice": {
                        "title": "Max price (USD)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Upper bound on price. For sales: total price. For rentals: monthly rent."
                    },
                    "minBedrooms": {
                        "title": "Min bedrooms",
                        "minimum": 0,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Use 0 for studios."
                    },
                    "maxBedrooms": {
                        "title": "Max bedrooms",
                        "minimum": 0,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Upper bound on bedroom count."
                    },
                    "minBathrooms": {
                        "title": "Min bathrooms",
                        "minimum": 0,
                        "maximum": 10,
                        "type": "number",
                        "description": "Lower bound on bathroom count. Decimal supported (1.5)."
                    },
                    "minSqft": {
                        "title": "Min square feet",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Lower bound on living area (square feet)."
                    },
                    "maxSqft": {
                        "title": "Max square feet",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Upper bound on living area (square feet)."
                    },
                    "amenities": {
                        "title": "Amenities (must include all selected)",
                        "uniqueItems": true,
                        "type": "array",
                        "description": "Filter to listings that advertise these amenities.",
                        "items": {
                            "type": "string",
                            "enum": [
                                "DOORMAN",
                                "ELEVATOR",
                                "GYM",
                                "POOL",
                                "GARAGE",
                                "PARKING_AVAILABLE",
                                "LAUNDRY_IN_BUILDING",
                                "WASHER_DRYER_IN_UNIT",
                                "DISHWASHER",
                                "PRIVATE_OUTDOOR_SPACE",
                                "TERRACE",
                                "BALCONY",
                                "ROOF_DECK",
                                "BIKE_ROOM",
                                "STORAGE",
                                "PETS_ALLOWED",
                                "FURNISHED",
                                "FIREPLACE",
                                "CENTRAL_AIR",
                                "VIRTUAL_DOORMAN"
                            ],
                            "enumTitles": [
                                "Doorman",
                                "Elevator",
                                "Gym",
                                "Pool",
                                "Garage",
                                "Parking available",
                                "Laundry in building",
                                "Washer/Dryer in unit",
                                "Dishwasher",
                                "Private outdoor space",
                                "Terrace",
                                "Balcony",
                                "Roof deck",
                                "Bike room",
                                "Storage",
                                "Pets allowed",
                                "Furnished",
                                "Fireplace",
                                "Central air",
                                "Virtual doorman"
                            ]
                        },
                        "default": []
                    },
                    "noFee": {
                        "title": "No-fee rentals only",
                        "type": "boolean",
                        "description": "Rentals: only listings with no broker fee. Ignored when saleType is not forRent.",
                        "default": false
                    },
                    "keywords": {
                        "title": "Keyword search",
                        "type": "string",
                        "description": "Free-text keyword filter (matches description / title)."
                    },
                    "sortBy": {
                        "title": "Sort order",
                        "enum": [
                            "RECOMMENDED",
                            "PRICE_ASC",
                            "PRICE_DESC",
                            "LISTED_AT_DESC",
                            "LISTED_AT_ASC",
                            "SQFT_DESC",
                            "BEDROOMS_DESC"
                        ],
                        "type": "string",
                        "description": "Order in which results are returned.",
                        "default": "RECOMMENDED"
                    },
                    "urls": {
                        "title": "URLs (paste any StreetEasy listing or search URL)",
                        "type": "array",
                        "description": "Examples:\n• https://streeteasy.com/for-sale/manhattan\n• https://streeteasy.com/for-rent/williamsburg/price:3000-5000\n• https://streeteasy.com/sold/nyc\n• https://streeteasy.com/building/the-lombardy/1401\nMulti-URL supported. Filter-mode fields are ignored. Pagination starts at the URL's page and walks forward.",
                        "items": {
                            "type": "string"
                        },
                        "default": []
                    },
                    "maxPages": {
                        "title": "Max pages per query (0 = unlimited)",
                        "minimum": 0,
                        "maximum": 50,
                        "type": "integer",
                        "description": "Pagination cap per query. Each page returns up to perPage listings (default 100). 0 = walk all pages until exhausted, bounded only by maxListings.",
                        "default": 0
                    },
                    "perPage": {
                        "title": "Listings per page",
                        "minimum": 10,
                        "maximum": 500,
                        "type": "integer",
                        "description": "Up to 500 supported. Higher values mean fewer round trips and lower cost.",
                        "default": 100
                    },
                    "maxListings": {
                        "title": "Max listings (0 = unlimited within budget)",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Hard cap across the whole run. The actor stops as soon as this many records have been pushed. Default 20 keeps small test runs cheap; bump it for production scrapes.",
                        "default": 20
                    },
                    "fetchDetails": {
                        "title": "Fetch detail pages (slower, more fields)",
                        "type": "boolean",
                        "description": "When on, the actor opens each listing page to enrich amenities, building info, agent contact, full description, and price history. Adds one HTTP request per listing.",
                        "default": false
                    },
                    "expandLargeQueries": {
                        "title": "Auto-expand queries above 1050 results",
                        "type": "boolean",
                        "description": "When on and a query matches more than the per-query cap (~1050), the actor splits it into price buckets and merges results so you can extract the full market.",
                        "default": false
                    },
                    "proxy": {
                        "title": "Proxy",
                        "type": "object",
                        "description": "Apify Residential US is required (StreetEasy blocks datacenter ranges). Country is forced to US.",
                        "default": {
                            "useApifyProxy": true,
                            "apifyProxyGroups": [
                                "RESIDENTIAL"
                            ],
                            "apifyProxyCountry": "US"
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
