Back to Realtor.com API
API Reference
Realtor.com API Documentation
Explore the available endpoints and integrate real estate data into your applications.
Authentication
Include your API key in the request header for all API calls:
Request Header
X-API-Key: rav_your_api_key_here
Endpoints
GET
/v1/realtor/properties
List Properties
Search and filter property listings by location, price, type, and more.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit |
int | No | Number of items to return per response for pagination (default: 20, max: 100) |
offset |
int | No | Page index for pagination, retrieval of subsequent sets of items |
state_code |
string | No | Filters properties based on the state code (e.g. TX, CA) |
city |
string | No | Filters properties based on the city name |
street_name |
string | No | Filters properties based on the street name |
address |
string | No | Filters properties based on the specific address |
postal_code |
string | No | Filters properties based on the postal code |
status |
array | No | Listing status: for_sale, ready_to_build, for_rent, sold, off_market, other, new_community |
type |
array | No | Property types: apartment, condo_townhome, multi_family, single_family, land, farm, mobile, etc. |
beds |
object | No | Filter by bedrooms. Example: {"min": 1, "max": 3} |
baths |
object | No | Filter by bathrooms. Example: {"min": 4} |
list_price |
object | No | Filter by list price. Example: {"min": 200, "max": 900} |
sold_price |
object | No | Filter by sold price. Example: {"min": 20000, "max": 40000} |
sold_date |
object | No | Filter by sold date. Example: {"min": "2022-03-25", "max": "2022-09-25"} |
sqft |
object | No | Filter by square footage. Example: {"min": 3000, "max": 5000} |
lot_sqft |
object | No | Filter by lot size in sqft. Example: {"min": 3000, "max": 5000} |
year_built |
object | No | Filter by year built. Example: {"min": 2017, "max": 2019} |
hoa_fee |
object | No | Filter by HOA fee. Example: {"max": 2}. No effect if no_hoa_fee is true |
no_hoa_fee |
boolean | No | Filter properties with no HOA fee (true/false) |
keywords |
string | No | Search keywords: basement, carport, central_air, dishwasher, fireplace, garage, hardwood_floors, pool, etc. |
search_location |
object | No | Proximity search. Example: {"radius": 25, "location": "2425 Sahalee Dr W"} |
boundary |
object | No | GEOJson polygon boundary. Example: {"coordinates": [[[-117.68, 35.27], ...]]} |
open_house |
object | No | Open house date range. Example: {"min": "2022-09-25", "max": "2022-10-25"} |
pending |
boolean | No | Filter pending properties (true/false) |
contingent |
boolean | No | Filter contingent properties (true/false) |
foreclosure |
boolean | No | Filter foreclosure properties (true/false) |
new_construction |
boolean | No | Filter newly constructed properties (true/false) |
has_tour |
boolean | No | Filter properties with tours available (true/false) |
matterport |
boolean | No | Filter properties with Matterport 3D tour (true/false) |
cats |
boolean | No | Filter properties allowing cats (true/false) |
dogs |
boolean | No | Filter properties allowing dogs (true/false) |
sort |
object | No | Sort results. Example: {"direction": "desc", "field": "list_date"}. Fields: photo_count, last_update_date, list_date, list_price, sold_price, beds, lot_sqft |
GET
/v1/realtor/property/{property_id}
Get Property Details
Get comprehensive details for a specific property including photos, history, tax records, and features.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
property_id |
string | Yes | The unique property identifier associated with a listing |
source_listing_id |
string | No | The MLS ID associated with a particular property listing |
GET
/v1/realtor/agents
List Agents
Search for real estate agents by location, name, or specialization.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
limit |
int | No | Number of items to return per response (default: 20) |
offset |
int | No | Page index for pagination |
city |
string | No | City name to search agents in |
state_code |
string | No | State code (e.g. TX, CA) |
postal_code |
string | No | Postal code to search agents in |
selling_agent_name |
string | No | First and last name of the selling agent |
agent_source_id |
string | No | Agent ID as returned in the agents list endpoint |
GET
/v1/realtor/agent/{agent_id}
Get Agent Details
Get detailed agent profile including ratings, active listings, and transaction history.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
agent_id |
string | Yes | The agent ID |
fulfillment_id |
string | No | Fulfillment ID associated with the agent, from agents list endpoint |
Ready to Start Building?
Get your API key and start integrating Realtor.com API today.