Realtor.com

Realtor.com Search API

Search Realtor.com for-sale, pending, for-rent and sold listings by location, radius or agent. Filter by price, beds, baths, square feet, lot size, year built, garage, HOA, property type, listing, sold or price-cut recency, keywords in the listing description, new construction, foreclosure and open houses. Up to 200 listings per call with list or sold price and date, lot size, address with coordinates, MLS id and listing agent. Costs 1 credit per request.

POST/api/v1/realtor/search

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your Scavio API key (e.g. Bearer sk_live_your_key).

Body

application/json

locationstring

Where to search: a city ("Austin, TX"), county ("Travis County, TX"), ZIP code, state or neighborhood. Pass this, latitude + longitude + radius_miles, or agent_id.

Example: Maricopa County, AZ

latitudenumber

Center latitude for a radius search, with longitude and radius_miles.

Example: 33.4484

longitudenumber

Center longitude for a radius search.

Example: -112.074

radius_milesnumber

Radius around latitude/longitude, 0.1 to 50 miles.

Example: 10

agent_idstring

Only this agent's listings (agent.agent_id from a search row, or agent_id from Agents).

Example: 642581

listing_statusstringdefault:for_sale

Which listings to search.

for_sale — Active listings, including pending and contingent, as on the site.
pending — Only pending or contingent listings.
for_rent — Rentals; prices are monthly rent.
sold — Recorded sales with sold price and date.

exclude_pendingboolean

for_sale only: leave out pending and contingent listings.

min_pricenumber

Minimum price in USD: list price, sold price on sold, monthly rent on for_rent.

Example: 100000

max_pricenumber

Maximum price in USD, same meaning as min_price.

Example: 500000

beds_mininteger

Minimum bedrooms.

beds_maxinteger

Maximum bedrooms.

baths_minnumber

Minimum bathrooms.

baths_maxnumber

Maximum bathrooms.

sqft_mininteger

Minimum interior square feet.

sqft_maxinteger

Maximum interior square feet.

lot_sqft_mininteger

Minimum lot size in square feet (1 acre = 43,560).

Example: 43560

lot_sqft_maxinteger

Maximum lot size in square feet.

year_built_mininteger

Built in or after this year (1700-2100).

year_built_maxinteger

Built in or before this year (1700-2100).

garage_mininteger

Minimum garage spaces.

max_hoanumber

Maximum monthly HOA fee in USD. Listings without an HOA fee are kept.

property_typesstring[]

Only these property types (1-7 values).

Example: ["land"]

single_family — Single-family homes.
condos — Condos and co-ops.
townhomes — Townhomes.
multi_family — Multi-family buildings.
land — Land and lots.
mobile — Mobile and manufactured homes.
farm — Farms and ranches.

listed_within_daysinteger

Only listings listed in the last N days (1-3650).

sold_within_daysinteger

sold only: only sales in the last N days (1-3650). 730 is the last two years.

Example: 730

price_reduced_within_daysinteger

Only listings with a price cut in the last N days (1-3650).

keywordsstring[]

Only listings whose listing description matches these keywords (1-10, each up to 60 characters).

Example: ["workshop"]

new_constructionboolean

Only new construction.

foreclosureboolean

Only foreclosures.

has_open_houseboolean

Only listings with an open house in the next 7 days.

sortstringdefault:relevance

Result order.

relevance — Realtor.com's default order.
newest — Newest list date first.
price_low — Lowest price first.
price_high — Highest price first (sold price on sold).
sold_newest — Most recent sale first (sold only).
sqft_high — Largest interior first.
lot_size_high — Largest lot first.
year_built_new — Newest construction first.
recently_updated — Most recently updated first.
recently_reduced — Most recent price cut first.

pageintegerdefault:1

Results page, 1-based. Stop at max_page.

Example: 2

page_sizeintegerdefault:50

Listings per page, 1-200. page x page_size may not exceed 10,000.

Example: 200

Notes

Sold prices and non-disclosure states. In US sold-price non-disclosure states (Texas, Utah, Wyoming, Alaska, Idaho, Kansas, Louisiana, Mississippi, Montana, New Mexico, North Dakota and parts of Missouri) sold_price is null; sold_date still comes back. Arizona, as in the captured example, carries full sold prices.

10,000 results per search. Realtor.com serves the first 10,000 results of a search, so page x page_size may not exceed 10,000 and max_page stops there. To cover a bigger area, slice it: run one search per price band, property type, county or ZIP code.

Keywords search the listing description. keywords keeps only listings whose description text matches, for example ["workshop"] or ["live/work"]. It works with every other filter, so a keyword watch across cities is one call per city.

Land comps. listing_status: "sold" with property_types: ["land"], sold_within_days, a price band and lot_sqft_min returns sold lots with price, date, lot size and coordinates, up to 200 per call.

Request

from scavio import ScavioClient

client = ScavioClient(api_key="sk_live_your_key")

# Land sold in Maricopa County in the last two years, lots of 1 acre or more
res = client.realtor.search(
    location="Maricopa County, AZ",
    listing_status="sold",
    property_types=["land"],
    sold_within_days=730,
    lot_sqft_min=43560,
    page_size=200,
)

for l in res["data"]["listings"]:
    print(l["sold_price"], l["sold_date"], l["lot_sqft"], l["address"]["city"])

Response

"listing_status": "sold",

"total": 6261,

"count": 10,

"page": 1,

"page_size": 10,

"max_page": 627,

"response_time": 2658

}

from scavio import ScavioClient client = ScavioClient(api_key="sk_live_your_key") # Land sold in Maricopa County in the last two years, lots of 1 acre or more res = client.realtor.search( location="Maricopa County, AZ", listing_status="sold", property_types=["land"], sold_within_days=730, lot_sqft_min=43560, page_size=200, ) for l in res["data"]["listings"]: print(l["sold_price"], l["sold_date"], l["lot_sqft"], l["address"]["city"])