Skip to main content
GET
Search Listings

Query Parameters

string
required
Free-text location: a city (“Austin, TX”), a ZIP/postal code, or a region (“Toronto, ON”). Required unless you pass a Canada bounding box (lat_min/lat_max/lng_min/lng_max).
string
default:"us"
Which market to search: us (realtor.com, USD) or ca (realtor.ca, CAD).
string
default:"for_sale"
Listing status filter.
number
Minimum list price in the market’s local currency.
number
Maximum list price in the market’s local currency.
integer
Minimum number of bedrooms.
integer
Minimum number of bathrooms.
integer
Minimum interior square footage. US market only.
integer
Maximum interior square footage. US market only.
string
Comma-separated list of property types. US market only.Values: single_family, condos, townhomes, multi_family, mobile, land.
string
default:"relevant"
Sort order for results.
integer
default:1
Page number for paginated results.
integer
Results per page. Range: 1 - 200.
number
South edge of a bounding box. Canada power-user option (realtor.ca caps ~600 results per box).
number
North edge of a bounding box. Canada only.
number
West edge of a bounding box. Canada only.
number
East edge of a bounding box. Canada only.

Response

string
The market that was searched (us or ca).
string
ISO 3166-1 alpha-2 country code for the market (US or CA).
integer
Total number of matching listings.
integer
Number of listings returned on this page.
integer
Current page number.
integer
Total number of pages available.
array
Array of matching properties.

Example Response

Each search request costs 8 credits. Failed requests are not charged.

Authorizations

x-api-key
string
header
required

Query Parameters

location
string
required

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

market
enum<string>
default:us

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

Available options:
us,
ca
status
enum<string>
default:for_sale

Listing status filter.

Available options:
for_sale,
for_rent,
sold,
pending
price_min
number

Minimum list price in the market's local currency.

Required range: x >= 0
price_max
number

Maximum list price in the market's local currency.

Required range: x >= 0
beds_min
integer

Minimum number of bedrooms.

Required range: x >= 0
baths_min
integer

Minimum number of bathrooms.

Required range: x >= 0
sqft_min
integer

Minimum interior square footage (US market only).

Required range: x >= 0
sqft_max
integer

Maximum interior square footage (US market only).

Required range: x >= 0
property_type
string

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

sort
enum<string>
default:relevant

Sort order for results.

Available options:
relevant,
newest,
price_low,
price_high,
photo_count
page
integer
default:1

Page number for paginated results.

Required range: x >= 1
limit
integer

Results per page (1-200).

Required range: 1 <= x <= 200
lat_min
number

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

lat_max
number

North edge of a bounding box (Canada only).

lng_min
number

West edge of a bounding box (Canada only).

lng_max
number

East edge of a bounding box (Canada only).

Response

200 - application/json

Matching listings

market
string
country
string
total
integer | null
count
integer
page
integer
total_pages
integer | null
results
object[]