docs / us-re
US Real Estate
US homes for sale and rent with details.
base /us-re/v16 endpoints
post
/us-re/v1/listings/search2 creditssearch for-sale listings in a location
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| location | required | — | Search location: a 'City, ST' string or a 5-digit ZIP code. |
| offset = 0 | optional | 0– | Pagination offset — skip N listings (results page in steps of 42). |
| status | optional | for_sale · ready_to_build · sold · off_market | Listing status filter for Realtor search (default for_sale). Accepts one value or a list; unknown values are passed through, not rejected. |
post
/us-re/v1/listings/detail3 creditsfull property: price + tax history, schools, photos
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| property_id | required | — | Realtor.com property id (the digits in a listing URL or a search result's property_id). |
post
/us-re/v1/property/estimates2 creditshome value estimates (Cotality/CoreLogic + Quantarium)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| property_id | required | — | Realtor.com property id (the digits in a listing URL or a search result's property_id). |
post
/us-re/v1/property/similar2 creditssimilar / related homes (comps)
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| property_id | required | — | Realtor.com property id (the digits in a listing URL or a search result's property_id). |
post
/us-re/v1/market/trends1 creditlocal housing-market medians (price/$psf/DOM/rent) by city or zip
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| location | required | — | Market area: a city ('Austin, TX' → austin_tx) or a 5-digit ZIP code. |
post
/us-re/v1/agents1 creditFind real-estate agents in a US city/area (Realtor.com agent search). Each agent: name, broker/office, average rating + review/recommendation counts, REALTOR flag, avatar and listing stats. Paginated (24/page).
| Parameter | Allowed / range | Description | |
|---|---|---|---|
| location | required | — | US city + state (e.g. 'Austin, TX', 'San Antonio, Texas'). |
| page = 1 | optional | 1– | Result page (24 agents per page). |
Example request · listings/search
curl -X POST https://api.reefapi.com/us-re/v1/listings/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"location":"Austin, TX"}'Response shape
{
"ok": true,
"data": { /* the result */ },
"meta": {
"latency_ms": 240,
"record_count": 12,
"completeness_pct": 100
},
"error": null
}