Skip to main content
GET
/
search
/
rentals
Search rental listings
curl --request GET \
  --url https://borough.qwady.app/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",
      "listingType": "rental"
    }
  ],
  "meta": {
    "total": 142,
    "page": 1,
    "perPage": 50,
    "dataAge": "2026-02-12T14:30:00Z",
    "source": "cached"
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

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
​
buildingType
string

Comma-separated building types. Valid values: RENTAL, CONDO, CO_OP, HOUSE, MULTI_FAMILY, TOWNHOUSE, TWOFAMILY, THREEFAMILY, MIXED_USE.

​
noFee
boolean

Filter for no-fee listings only. Data coverage is currently limited and may undercount while listing-detail backfills complete.

​
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. Data coverage is currently limited and may undercount while listing-detail backfills complete.

​
minSqft
integer

Minimum square footage

Required range: x >= 1
​
maxSqft
integer

Maximum square footage

Required range: x >= 1
​
petsAllowed
boolean

Filter by listing-level pet flag or building-level pet policy

​
amenities
string

Comma-separated amenity codes. Listings must match all requested amenities across listing- and building-level data.

​
maxMonthlyCost
integer

Maximum total monthly cost where maintenance, common charges, and property tax fields are populated. Falls back to price when those fields are unknown.

Required range: x >= 0
​
minTransitScore
integer

Minimum transit score (0-100) based on proximity and stop density within 400 meters. Scores are strict; 80+ means exceptional transit clusters, not ordinary good subway access.

Required range: 0 <= x <= 100
​
fiberOnly
boolean

Require an FCC public-data provider match with fiber technology. Coverage may be exact-building or Census-block level depending on imported area.

​
minDownloadMbps
integer

Require an FCC public-data provider match with at least this advertised download speed in Mbps. Coverage may be exact-building or Census-block level depending on imported area.

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

Sort attribute

Available options:
RECOMMENDED,
PRICE,
LISTED_AT
​
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