# Realtor.com Property Search API Documentation

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).

- **Documentation:** [https://scrappa.co/docs/realtor-com-api/realtor_com_search](https://scrappa.co/docs/realtor-com-api/realtor_com_search) - **API group:** Realtor.com API - **Endpoint:** `GET https://scrappa.co/api/realtor-com/search` ## Authentication Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key. ## Parameters | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `status` | string | Yes | for_sale, for_rent or sold. | | `location` | string | No | 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. | | `latitude` | number | No | Center of a radius search. Send with longitude and radius_mi instead of location. | | `longitude` | number | No | Center of a radius search. | | `radius_mi` | number | No | Radius around the center, 0.1 to 100 miles. | | `min_price` | integer | No | Minimum list price (rent per month for for_rent) in USD. | | `max_price` | integer | No | Maximum list price in USD. | | `min_beds` | integer | No | Minimum bedrooms. | | `max_beds` | integer | No | Maximum bedrooms. | | `min_baths` | integer | No | Minimum bathrooms. | | `max_baths` | integer | No | Maximum bathrooms. | | `min_sqft` | integer | No | Minimum living area in square feet. | | `max_sqft` | integer | No | Maximum living area in square feet. | | `type` | string | No | Comma separated list of single_family, condos, mobile, land, duplex_triplex, apartment. | | `sort` | string | No | list_date, list_price or sold_date (sold_date only with status=sold). Default: list_date, or sold_date for sold. | | `order` | string | No | asc or desc. Default desc. | | `sold_within_days` | integer | No | Only with status=sold: sales of the last 1 to 1095 days. Default 30. | | `page` | integer | No | Page number, default 1. page * per_page must not exceed 10000. | | `per_page` | integer | No | Rows per page, 1 to 200. Default 40. | ## Example response ```json { "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 | Status | Error | Description | | --- | --- | --- | | 422 | Validation Error | A required parameter is missing or invalid. This response is not billable. | | 503 | Temporarily Unavailable | Realtor.com did not answer after several attempts. This response is not billable. Retry after a short pause. | ## More Scrappa resources - [API documentation](https://scrappa.co/docs) - [Full LLM-readable API reference](https://scrappa.co/llms-full.txt) - [OpenAPI specification](https://scrappa.co/docs/api.json) - [Pricing](https://scrappa.co/pricing)