Skip to main content
GET
Search Listings

Query Parameters

location
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).
market
string
default:"us"
Which market to search: us (realtor.com, USD) or ca (realtor.ca, CAD).
status
string
default:"for_sale"
Listing status filter.
price_min
number
Minimum list price in the market’s local currency.
price_max
number
Maximum list price in the market’s local currency.
beds_min
integer
Minimum number of bedrooms.
baths_min
integer
Minimum number of bathrooms.
sqft_min
integer
Minimum interior square footage. US market only.
sqft_max
integer
Maximum interior square footage. US market only.
property_type
string
Comma-separated list of property types. US market only.Values: single_family, condos, townhomes, multi_family, mobile, land.
sort
string
default:"relevant"
Sort order for results.
page
integer
default:1
Page number for paginated results.
limit
integer
Results per page. Range: 1 - 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

market
string
The market that was searched (us or ca).
country
string
ISO 3166-1 alpha-2 country code for the market (US or CA).
total
integer
Total number of matching listings.
count
integer
Number of listings returned on this page.
page
integer
Current page number.
total_pages
integer
Total number of pages available.
results
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[]