Skip to main content
GET
Search Properties For Sale

Authorizations

x-rapidapi-key
string
header
required

Rapid API Key

Query Parameters

location
string
required

Location

Minimum string length: 1
Example:

"20002"

page
integer
default:1

Page number for pagination

Example:

1

sort_by
enum<string>
default:relevant_listings

Sort results by the specified criteria

  • relevant_listings: Relevant listings
  • newest_listings: Newest listings
  • lowest_price: Lowest price
  • highest_price: Highest price
  • year_built: Year built
  • open_house_date: Open house date
  • recently_reduced: Recently reduced
  • largest_sqft: Largest sqft
  • lot_size: Lot size
  • photo_count: Photo count
Available options:
relevant_listings,
newest_listings,
lowest_price,
highest_price,
year_built,
open_house_date,
recently_reduced,
largest_sqft,
lot_size,
photo_count
Example:

"relevant_listings"

list_price_range
string

list_price_range filter in format min,max

Example 50000,1000000 means price from $50,000 to $1,000,000

Example:

"50000,1000000"

is_price_reduced
boolean

Price reduced

Example:

true

is_builder_promotions
boolean

Builder promotions

Example:

true

monthly_payment_range
string

monthly_payment_range filter in format min,max

Example 50000,1000000 means price from $50,000 to $1,000,000

Example:

"50000,1000000"

monthly_down_payment
integer

Down payment

Example:

1000

number_of_bedrooms
integer

Filter by minimum number of bedrooms. The value represents the lower bound. For example, if 1 is provided, the query will return properties with 1 or more bedrooms (bedrooms >= 1)

Example:

1

number_of_bathrooms
integer

Filter by minimum number of bathrooms. The value represents the lower bound. For example, if 1 is provided, the query will return properties with 1 or more bathrooms (bathrooms >= 1)

Example:

1

home_types
string

Filter listings by home type

You can use one or multiple values separated by commas ,

  • house: House
  • condo: Condo
  • townhome: Townhome
  • multi_family: Multi Family
  • mobile: Mobile
  • farm: Farm
  • land: Land
Example:

"house,condo"

status
string
default:active,pending_or_contingent

Filter listings by status

You can use one or multiple values separated by commas ,

  • active: Active
  • pending_or_contingent: Pending/contingent
type
string
default:existing_homes,foreclosures,new_construction,55_plus_community

Filter listings by type

You can use one or multiple values separated by commas ,

  • existing_homes: Existing homes
  • foreclosures: Foreclosures
  • new_construction: New construction
  • 55_plus_community: 55+ community
days_on_realtor
integer

Days on Realtor.com

Example:

30

square_feet_range
string

square_feet_range filter in format min,max

Example 500,2000 square feet from 500 to 2000

Example:

"500,2000"

lot_size_range
string

lot_size_range filter in format min,max

Example: 1000,2000 lot size from 1000 sqft to 2000 sqft

Example:

"1000,2000"

year_built_range
string

year_built_range filter in format min,max

Example: 2015,2020 year built from 2015 to 2020

Example:

"2015,2020"

max_hoa_fees_per_month
integer

Max HOA Fees per month

Example:

500

garage
integer

Garage

Example:

1

is_single_story_only
boolean

Single-story only

Example:

true

home_features
string

Filter listings by home features

You can use one or multiple values separated by commas ,

Example:

"Pool,Lake view"

interior
string

Filter listings by interior

You can use one or multiple values separated by commas ,

  • disability_features: Accessibility
  • basement: Basement
  • central_air: Central Air
  • central_heat: Central Heat
  • den_or_office: Den/office
  • dining_room: Dining room
  • elevator: Elevator
  • energy_efficient: Energy efficient
  • family_room: Family room
  • fireplace: Fireplace
  • forced_air: Forced air
  • game_room: Game room
  • hardwood_floors: Hardwood floors
  • washer_dryer: In-home laundry
Example:

"disability_features,basement"

exterior
string

Filter listings by exterior

You can use one or multiple values separated by commas ,

  • carport: Carport
  • corner_lot: Corner lot
  • cul_de_sac: Cul-de-sac
  • golf_course_lot_or_frontage: Golf course lot
  • horse_facilities: Horse facility
  • swimming_pool: Pool
  • rv_or_boat_parking: RV / boat parking
  • spa_or_hot_tub: Spa / hot tub
Example:

"carport,corner_lot"

views
string

Filter listings by views

You can use one or multiple values separated by commas ,

  • city_view: City view
  • golf_course_view: Golf course view
  • hill_or_mountain_view: Hill / mtn view
  • lake_view: Lake view
  • ocean_view: Ocean view
  • river_view: River view
  • waterfront: Waterfront
Example:

"city_view,golf_course_view"

community
string

Filter listings by community

You can use one or multiple values separated by commas ,

  • senior_community: 55+ community
  • community_boat_facilities: Boat facility
  • community_clubhouse: Clubhouse
  • community_golf: Golf course
  • community_horse_facilities: Horse facility
  • community_park: Park
  • community_swimming_pool: Pool
  • recreation_facility: Recreation facility
  • community_security_features: Security feature
  • community_spa_or_hot_tub: Spa / hot tub
  • tennis_court: Tennis court
Example:

"senior_community,community_boat_facilities"

Response

Success

success
boolean
Example:

true

cost
number

Cost of the request

Example:

1

total
number

Total number of properties matching the search criteria

Example:

792

has_more
boolean

Whether there are more data to fetch

Example:

true

data
object[]