---
title: "Search StreetEasy rental listings"
method: GET
path: "/streeteasy/rentals/search"
tags: ["StreetEasy"]
---

# Search StreetEasy rental listings

`GET /streeteasy/rentals/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/streeteasy/rentals/search`
- Auth: API key in header `x-api-key`

Searches active StreetEasy rentals in one or more areas with the public site's price, room, building, amenity, pet, open-house, tour, transit, and sort filters. Obtain valid area IDs from /streeteasy/areas.

## Query parameters

- `area_id` integer[], required
- `page` integer
- `per_page` integer
- `sort` 'default' | 'newest' | 'recently_updated' | 'price_desc' | 'price_asc' | 'largest' | 'smallest'
- `min_price` integer
- `max_price` integer
- `min_bedrooms` integer
- `max_bedrooms` integer
- `min_bathrooms` number
- `max_bathrooms` number
- `min_sqft` integer
- `max_sqft` integer
- `building_type` string[]
- `amenity` string[]
- `optional_amenity` string[]
- `pets_allowed` boolean
- `open_house` boolean
- `tour_3d` boolean
- `video_tour` boolean
- `transit_line` string[]

## Headers

- `x-api-key` string, required

## Response `200`

OK

- StreeteasyRentalSearch
  - `edges` StreeteasyRentalEdge[]
    - `node` StreeteasyRentalListing
      - `advertisedOnSe` boolean
      - `areaName` string
      - `bedroomCount` integer
      - `buildingType` string
      - `fullBathroomCount` integer
      - `furnished` boolean
      - `geoPoint` StreeteasyGeoPoint
        - `latitude` number
        - `longitude` number
      - `halfBathroomCount` integer
      - `id` string
      - `isPremiumHdpEnabled` boolean
      - `leadMedia` StreeteasyLeadMedia
        - `photo` StreeteasyPhoto
          - `key` string
      - `offMarketAt` string
      - `price` number
      - `saleType` string
      - `sourceGroupLabel` string
      - `status` string
      - `street` string
      - `tier` string
      - `totalMonthlyPrice` number
      - `unit` string
      - `urlPath` string
    - `type` string
  - `search` object
    - `criteria` string
  - `totalCount` integer

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/028417aa35bb?raw)