# Realtor.com (/docs/realtor) Search Realtor.com homes for sale or for rent from a search link, then read one home with its description and photos Realtor.com lists homes for sale and homes for rent across the United States. These endpoints read a Realtor.com search link and return its homes page by page, and read one home by its link. Every home uses the canonical `Place` shape, and the listing facts sit in `place.ext.listing`, the same shape Zillow and Redfin homes use. Base URL: `/v1/realtor/...` Realtor.com exposes 2 routes here. ## Quickstart ### Search an area Copy a Realtor.com search link and pass it as `url`: a city, ZIP code or neighborhood search under `/realestateandhomes-search/`, or a rental search under `/apartments/`. Filters in the link are kept. `limit` sets how many homes come back on a page. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FAustin_TX&limit=40" \ -H "x-api-key: YOUR_API_KEY" ``` ```json title="Response (trimmed)" { "success": true, "data": { "items": [ { "place": { "id": "7006116543", "name": "2200 Dickson Dr Apt 127", "address": "2200 Dickson Dr Apt 127, Austin, TX 78704", "category": "condo", "ext": { "listing": { "price": 269000, "currency": "USD", "status": "for_sale", "beds": 1, "baths": 1, "sqft": 640, "year_built": 2008, "home_type": "condo" } } } } ], "total": 389, "next_cursor": "2" } } ``` ### Read one home Pass a home's Realtor.com link as `url`; `place.url` on every search row is one. The record adds the description and the photo gallery. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/realtor/property?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-detail%2F14109-Willow-Tank-Dr_Austin_TX_78717_M78336-55435" \ -H "x-api-key: YOUR_API_KEY" ``` ### Read the next page Pass the returned `cursor` to read the next page of the same search. ```bash title="cURL" curl "https://www.socialcrawl.dev/v1/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FAustin_TX&cursor=2" \ -H "x-api-key: YOUR_API_KEY" ``` ## Questions people ask ### Does it cover rentals? Yes. Pass a rental search link under `/apartments/`, for example `https://www.realtor.com/apartments/Austin_TX`. Rows come back with `status` `for_rent` and the monthly rent as `price`. ### Is there a price history? No. Realtor.com search rows and home records carry the current price only, so `place.ext.listing.price_history` stays null. For a home's price and tax history use [Zillow](/docs/zillow.md) or [Redfin](/docs/redfin.md). ### Why can a home appear twice? Realtor.com reorders its pages between calls, so a home can sit on two consecutive pages. Each page is already de-duplicated; de-duplicate on `place.id` when you crawl several pages. ## All endpoints **How far back and how deep** Each list returns one page at a time. Send `cursor` for the next page, or `max_items` or `max_pages` to collect several pages in one call. A page size appears only where it has been verified. [How paging works](/docs/pagination.md). | Path | Rows per page | Date window | One call collects | | --- | --- | --- | --- | | `/v1/realtor/search` | about 40 | none | up to 5,000 rows or 50 pages; `limit` up to 200 | ## Platform notes **Money is in US dollars and areas are in square feet.** `place.ext.listing.currency` says so on every row. **A link is the way to name an area.** Build the search on realtor.com with the filters you want and pass its link; the filters travel with it. ## Next steps - [Zillow](/docs/zillow.md): The same Place and listing shape, with price and tax history. - [Apartments.com](/docs/apartments.md): Rental buildings with rent by bedroom count and specials.