Skip to main content
GET
/
search
/
rentals
Search rental listings
curl --request GET \
  --url https://borough.qwady.com/v1/search/rentals \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "4961849",
      "address": {
        "street": "157 West 57th Street",
        "unit": "#48B",
        "city": "NEW YORK",
        "state": "NY",
        "zipCode": "10019"
      },
      "price": 27000,
      "bedroomCount": 2,
      "fullBathroomCount": 2,
      "halfBathroomCount": 1,
      "buildingType": "CONDO",
      "areaName": "Midtown",
      "status": "ACTIVE",
      "geoPoint": {
        "latitude": 40.7654,
        "longitude": -73.9791
      },
      "leadPhotoKey": "ed2987594843debc8e828fef155dbb6d",
      "sourceGroupLabel": "Douglas Elliman",
      "urlPath": "/building/one57-condominium/48b",
      "tier": "PREMIUM"
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "perPage": 50,
    "dataAge": "2026-02-12T14:30:00Z",
    "source": "cached"
  }
}

Authorizations

​
Authorization
string
header
required

Polar.sh license key. Format: BOROUGH_<uuid>

Query Parameters

​
areas
string

Comma-separated area IDs (e.g., 120,115). See /areas for the full list.

​
minPrice
integer
​
maxPrice
integer
​
minBeds
integer
​
maxBeds
integer
​
minBaths
integer
​
maxBaths
integer
​
minSqft
integer
​
maxSqft
integer
​
amenities
string

Comma-separated amenity enums

​
petsAllowed
boolean
​
buildingType
string

Comma-separated building types

​
noFee
boolean
​
prewar
boolean
​
transitLines
string

Comma-separated subway lines

​
minDaysOnMarket
integer

Minimum days on market

Required range: x >= 0
​
maxDaysOnMarket
integer

Maximum days on market

Required range: x >= 0
​
listedAfter
string<date-time>

Only listings created after this date (ISO 8601)

​
listedBefore
string<date-time>

Only listings created before this date (ISO 8601)

​
hasOpenHouse
boolean

Filter to listings with a scheduled open house

​
has3dTour
boolean

Filter to listings with a 3D virtual tour

​
maxMonthlyCost
integer

Maximum total monthly cost (price + maintenance + common charges + property tax). Useful for sales.

Required range: x >= 0
​
minTransitScore
integer

Minimum transit score (0-100) based on proximity to subway/bus stops

Required range: 0 <= x <= 100
​
sort
enum<string>
default:RECOMMENDED

Sort attribute

Available options:
RECOMMENDED,
PRICE,
LISTED_AT,
PRICE_PER_SQFT
​
sortDir
enum<string>
default:DESC

Sort direction

Available options:
ASC,
DESC
​
page
integer
default:1

Page number (1-indexed)

Required range: x >= 1
​
perPage
integer
default:50

Results per page. Maximum depends on tier: Free=10, Starter=50, Pro/Business=500.

Required range: 1 <= x <= 500

Response

Paginated list of rental listings

​
data
object[]
​
meta
object