Realtor.com Property Search API Search US homes for sale, for rent or sold. Filter by price, bedrooms, bathrooms, living area and property type, search a city, ZIP code or a radius, sort and page through the results. Each row has price, address, coordinates, photos, size, flags and the listing agent and broker. Every filter is applied by Realtor.com and checked again on each row. Rows dropped by that check are counted in meta.filtered_out. Rental communities have no unit data (beds, baths and sqft are null): they stay in the results with unit_data_available=false, because a bedroom or size filter cannot be proven for them. Sold rows carry the sale date in last_sold_date; Realtor.com does not publish the sale price, so no sold price is returned. A search serves at most 10000 rows (page * per_page).
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
1 required parameter needed before sending a request.
18 optional filters available.
string
Required
for_sale, for_rent or sold.
example
string
Optional
City and state (Austin, TX), ZIP code (78704) or a slug_id from the autocomplete endpoint (Austin_TX). Required unless latitude, longitude and radius_mi are sent.
Austin, Texas
number
Optional
Center of a radius search. Send with longitude and radius_mi instead of location.
10
number
Optional
Center of a radius search.
10
number
Optional
Radius around the center, 0.1 to 100 miles.
10
integer
Optional
Minimum list price (rent per month for for_rent) in USD.
10
integer
Optional
Maximum list price in USD.
10
integer
Optional
Minimum bedrooms.
10
integer
Optional
Maximum bedrooms.
10
integer
Optional
Minimum bathrooms.
10
integer
Optional
Maximum bathrooms.
10
integer
Optional
Minimum living area in square feet.
10
integer
Optional
Maximum living area in square feet.
10
string
Optional
Comma separated list of single_family, condos, mobile, land, duplex_triplex, apartment.
example
string
Optional
list_date, list_price or sold_date (sold_date only with status=sold). Default: list_date, or sold_date for sold.
relevance
string
Optional
asc or desc. Default desc.
example
integer
Optional
Only with status=sold: sales of the last 1 to 1095 days. Default 30.
10
integer
Optional
Page number, default 1. page * per_page must not exceed 10000.
1
integer
Optional
Rows per page, 1 to 200. Default 40.
10
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"page": 1,
"count": 2,
"status": "for_sale",
"has_more": true,
"listings": [
{
"url": "https://www.realtor.com/realestateandhomes-detail/1207-Crupp-Ct_Austin_TX_78753_M73888-23770",
"beds": 3,
"sqft": 1498,
"type": "single_family",
"baths": 3,
"flags": {
"pending": null,
"contingent": null,
"foreclosure": null,
"new_listing": true,
"price_reduced": null
},
"photos": [
"https://ap.rdcpix.com/5b98950dad4b449ab024236ca8512891l-m3065344006s.jpg",
"https://ap.rdcpix.com/5b98950dad4b449ab024236ca8512891l-m1419341019s.jpg"
],
"status": "for_sale",
"address": {
"city": "Austin",
"line": "1207 Crupp Ct",
"state_code": "TX",
"postal_code": "78753"
},
"lot_sqft": 10346,
"list_date": "2026-10-25T12:34:51.000000Z",
"permalink": "1207-Crupp-Ct_Austin_TX_78753_M73888-23770",
"list_price": 310000,
"listing_id": "3002415847",
"year_built": 1984,
"advertisers": [
{
"name": "Freddy Arauz",
"type": "seller",
"broker": "Compass RE Texas, LLC. - Broker",
"office": "Compass RE Texas LLC - Austin"
}
],
"coordinates": {
"lat": 30.381199,
"lon": -97.66245
},
"open_houses": [],
"property_id": "7388823770",
"primary_photo": "https://ap.rdcpix.com/5b98950dad4b449ab024236ca8512891l-m3065344006s.jpg",
"last_sold_date": "2022-02-14",
"unit_data_available": true
},
{
"url": "https://www.realtor.com/realestateandhomes-detail/1107-Rebbeca-Dr_Austin_TX_78758_M77072-72774",
"beds": 3,
"sqft": 1681,
"type": "single_family",
"baths": 2,
"flags": {
"pending": null,
"contingent": null,
"foreclosure": null,
"new_listing": true,
"price_reduced": null
},
"photos": [
"https://ap.rdcpix.com/0a54f8a99d29a246ce00624873f95a11l-m412743967s.jpg",
"https://ap.rdcpix.com/0a54f8a99d29a246ce00624873f95a11l-m623220545s.jpg"
],
"status": "for_sale",
"address": {
"city": "Austin",
"line": "1107 Rebbeca Dr",
"state_code": "TX",
"postal_code": "78758"
},
"lot_sqft": 10785,
"list_date": "2026-10-25T12:14:41.000000Z",
"permalink": "1107-Rebbeca-Dr_Austin_TX_78758_M77072-72774",
"list_price": 435000,
"listing_id": "3002415787",
"year_built": 1967,
"advertisers": [
{
"name": "Freddy Arauz",
"type": "seller",
"broker": "Compass RE Texas, LLC. - Broker",
"office": "Compass RE Texas LLC - Austin"
}
],
"coordinates": {
"lat": 30.388773,
"lon": -97.689846
},
"open_houses": [],
"property_id": "7707272774",
"primary_photo": "https://ap.rdcpix.com/0a54f8a99d29a246ce00624873f95a11l-m412743967s.jpg",
"last_sold_date": "2023-06-29",
"unit_data_available": true
}
],
"per_page": 2,
"filters_applied": [],
"total_matching_count": 2317
},
"meta": {
"billable": true,
"filtered_out": 0,
"endpoint_family": "search"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A required parameter is missing or invalid. This response is not billable.
{
"errors": {
"status": [
"The value is not valid."
]
},
"message": "The request validation failed"
}Temporarily Unavailable
Realtor.com did not answer after several attempts. This response is not billable. Retry after a short pause.
{
"meta": {
"attempts": 3,
"billable": false,
"retryable": true
},
"error": {
"message": "Realtor.com data is temporarily unavailable. Please retry.",
"failure_type": "upstream_blocked"
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.