v1

latestOpenAPI 3.1.02026-07-26180242448.0 KB

Realtor Search

Search Listings

Search a realtor.com (US) or realtor.ca (CA) market for property listings.

get/v1/realtor/search

locationstring required

Free-text location (city, ZIP/postal code, or region). Required unless a Canada bounding box is supplied.

market'us' | 'ca'

Market to search: us (realtor.com, USD) or ca (realtor.ca, CAD).

status'for_sale' | 'for_rent' | 'sold' | 'pending'

Listing status filter.

price_minnumber

Minimum list price in the market's local currency.

price_maxnumber

Maximum list price in the market's local currency.

beds_mininteger

Minimum number of bedrooms.

baths_mininteger

Minimum number of bathrooms.

sqft_mininteger

Minimum interior square footage (US market only).

sqft_maxinteger

Maximum interior square footage (US market only).

property_typestring

Comma-separated property types (US market only): single_family, condos, townhomes, multi_family, mobile, land.

sort'relevant' | 'newest' | 'price_low' | 'price_high' | 'photo_count'

Sort order for results.

pageinteger

Page number for paginated results.

limitinteger

Results per page (1-200).

lat_minnumber

South edge of a bounding box (Canada power-user option; realtor.ca caps ~600 results per box).

lat_maxnumber

North edge of a bounding box (Canada only).

lng_minnumber

West edge of a bounding box (Canada only).

lng_maxnumber

East edge of a bounding box (Canada only).

Matching listings

marketstring

countrystring

totalinteger nullable

countinteger

pageinteger

total_pagesinteger nullable