realtor.com APIrealtor.com ↗
Access Realtor.com property listings, detailed property info, agent search, location autocomplete, and market analytics via a single REST API.
curl -X GET 'https://api.parse.bot/scraper/8fac95fb-f5aa-42ec-8b47-f4c2de511855/search_properties?limit=2&beds_min=3&location=Austin%2C+TX&property_type=%5B%22single_family%22%5D' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for real estate properties by location (city/state or ZIP code) with support for status, price, beds, baths, and property type filters. Returns paginated results sorted by the specified field.
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results to return per page. |
| offset | integer | Pagination offset (number of results to skip). |
| status | string | JSON array of listing statuses to filter by. Accepted values include 'for_sale' and 'for_rent'. Example: '["for_sale"]'. |
| beds_min | integer | Minimum number of bedrooms filter. |
| locationrequired | string | Location to search. Accepts 'City, ST' format (e.g. 'Austin, TX') or a 5-digit ZIP code (e.g. '78701'). |
| baths_min | number | Minimum number of bathrooms filter. |
| max_price | integer | Maximum listing price filter. |
| min_price | integer | Minimum listing price filter. |
| sort_field | string | Field to sort results by. Accepted values: 'list_date', 'list_price'. |
| property_type | string | JSON array of property types to filter by. Accepted values include 'single_family', 'condos', 'multi_family', 'mobile', 'land', 'farm', 'townhomes'. Example: '["single_family", "condos"]'. |
| sort_direction | string | Sort direction. Accepted values: 'asc', 'desc'. |
{
"type": "object",
"fields": {
"count": "integer, number of properties returned in this response",
"total": "integer, total number of matching properties available",
"properties": "array of property summary objects with property_id, list_price, list_date, status, description, location, and photos"
},
"sample": {
"data": {
"count": 2,
"total": 1226,
"properties": [
{
"href": "https://www.realtor.com/realestateandhomes-detail/6321-Celia-Vista-Dr_San-Diego_CA_92115_M25130-85407",
"photos": [
{
"href": "http://ap.rdcpix.com/7f971be2471933e06d3054a48194e616l-m3709918455s.jpg"
}
],
"status": "for_sale",
"location": {
"address": {
"city": "San Diego",
"line": "6321 Celia Vista Dr",
"state_code": "CA",
"postal_code": "92115"
}
},
"list_date": "2026-05-07T18:16:36.000000Z",
"list_price": 874999,
"listing_id": "2994949411",
"description": {
"beds": 3,
"sqft": 1391,
"type": "single_family",
"lot_sqft": 18000,
"baths_consolidated": "1"
},
"property_id": "2513085407"
}
]
},
"status": "success"
}
}About the realtor.com API
This API exposes 5 endpoints covering Realtor.com's property listings, detailed records, agent matching, and market analytics. Use search_properties to query active listings by city, state, or ZIP code with filters for price, beds, baths, and status, then pass a property_id to get_property_details to retrieve tax history, price history, school ratings, and full descriptions for any individual listing.
Property Search and Details
The search_properties endpoint accepts a required location parameter in either City, ST or 5-digit ZIP format, and supports optional filters including min_price, max_price, beds_min, baths_min, and a status array that accepts values like for_sale and for_rent. Results are paginated via limit and offset, and each returned property object includes property_id, list_price, list_date, status, description, location, and photos.
Passing a property_id from search results to get_property_details returns a richer record: the description object adds beds, baths_consolidated, sqft, lot_sqft, type, text, and year_built. The response also includes tax_history (an array of annual tax amounts and assessment totals), property_history (dated events such as price changes and prior sales), and a schools object with name, rating, and grade ranges for nearby institutions.
Agent Search and Location Utilities
The search_agents endpoint takes a 5-digit postal_code and returns agent profiles through the upnest_automatch_agents_by_zip_code object, which includes each agent's name, license number, brokerage name, and years of experience. The get_location_suggestions endpoint accepts a partial string and returns ranked hits — each with area_type, city, state_code, postal_code, centroid coordinates, and a slug_id — making it suitable for driving search autocomplete UI.
Market Analytics
The get_market_analytics endpoint accepts a city/state or ZIP code and returns median_listing_price for that area. This is a single aggregate figure per location query, useful for quick price benchmarking or trend dashboards when combined with search data from search_properties.
- Build a property search app filtering Realtor.com listings by price range, bedroom count, and rental vs. sale status
- Display school ratings and tax history on individual property detail pages using
get_property_detailsresponse fields - Match home buyers with local agents by postal code using the
search_agentsendpoint's brokerage and experience data - Power a location autocomplete input field with city, county, and ZIP suggestions from
get_location_suggestions - Show median listing prices by city or ZIP for a market comparison dashboard using
get_market_analytics - Track historical price changes and prior sale events for a specific property using the
property_historyarray - Aggregate tax assessment records across a portfolio of properties by batching
get_property_detailsrequests
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Realtor.com have an official developer API?+
What does `get_property_details` return beyond what appears in search results?+
get_property_details endpoint adds several fields not present in search_properties results: tax_history (annual tax amounts and assessment totals), property_history (dated events including past sales and price changes), schools (nearby school names, ratings, and grade ranges), and an expanded description object that includes sqft, lot_sqft, year_built, and free-text description. The search endpoint returns summary-level fields only.Can I filter `search_properties` results by property type or sort field?+
status filtering via a JSON array (e.g. for_sale, for_rent) and numeric filters for min_price, max_price, beds_min, and baths_min. The endpoint description references sort field support. There is no explicit property type filter exposed in the current parameter set. You can fork this API on Parse and revise it to add a property type filter if that field is available in the underlying data.Does the API cover rental listings or only properties for sale?+
status filter in search_properties accepts both for_sale and for_rent values, so both active sale listings and rentals are within scope. The get_market_analytics endpoint returns a single median_listing_price figure and does not currently expose a separate median rent metric. You can fork the API on Parse and revise it to add a rental-specific analytics endpoint.Is property coverage limited to specific US regions?+
search_properties and search_agents endpoints accept US city/state combinations and 5-digit ZIP codes, so coverage is US-only. International property markets are not covered by the current endpoints. You can fork this API on Parse and revise it to add support for international real estate sources if needed.