Realtor.com Search

Search Realtor.com listings from a search URL.

GET/api/v1/realtor/search

Alpha: this endpoint is new and its response fields may still change.

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Request parameters

Search Realtor.com listings from a search URL.

Parameter	Type	Description
`limit`	integer	Listings per results page, from 1 to 200.Default: 40.Range: 1 to 200.
`url`required	string	Realtor.com city_STATE or ZIP search URL under /realestateandhomes-search/ or /apartments/.Up to 4,096 characters.Alpha: availability may vary by location or property.Supported URL filters: price, beds, baths, sqft, type-single-family-home, show-recently-sold and pg-1 through pg-100. Unsupported filters and query parameters are rejected. Follow pagination.next when present. Bedroom filters require whole numbers.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: properties. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/realtor/search?url=https%3A%2F%2Fwww.realtor.com%2Frealestateandhomes-search%2FAustin_TX%2F&limit=5" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "url": "https://www.realtor.com/realestateandhomes-search/Austin_TX/",
  "limit": 5
});
const res = await fetch(`https://serpfast.com/api/v1/realtor/search?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "url": "https://www.realtor.com/realestateandhomes-search/Austin_TX/",
  "limit": 5
}
res = requests.get(
    "https://serpfast.com/api/v1/realtor/search",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())