Search US & Canada MLS Listings (For-Sale, For-Rent, Sold)
GET/v1/properties/search2 Credits / Property($0.08–$0.20 / 1K properties)· Updated 2026-11-15
Direct Answer · PropTech Engineering Summary
GET /v1/properties/search queries active for-sale, for-rent, and recently sold US & Canada real estate listings by 5-digit ZIP code (?location=78701) or city/state (?location=Austin, TX). It automatically normalizes bare ZIPs into postal_code:78701 and cities into city:Austin, TX across dual failover rails, returning list price, AVM estimated value, instant equity %, estimated monthly rent, gross cap rate %, beds/baths/sqft, HOA, property tax, and school ratings at 2 Credits ($0.0002) per property.
Honest Trade-Offs & Scope Boundaries
- →Returns up to 50 normalized property summaries per page (default 20); call GET /v1/properties/detail?property_id=... when you need the full 37-photo gallery, historical deed/tax table, and complete room-by-room specs.
- →Warm PostgreSQL 16 + Redis DB 8 cache serves repeat ZIP/city queries in 20–40ms (6-hour TTL); pass ?fresh=1 on paid plans when sub-minute MLS status changes are required.
- →Empty ZIP searches (0 matching properties) strictly deduct 0 Credits.
Primary-Source Benchmark & Gateway Telemetry
“Bridge Interactive API access requires an executed data license agreement and approval from each participating Multiple Listing Service (MLS) prior to receiving production credentials.”
— Zillow Group / Bridge Interactive API Documentation (retrieved 2026-11-15)
PropTech startups and AI agent builders who cannot wait 4–12 weeks for per-board MLS approvals use /v1/properties/search to query normalized public listing & AVM feeds immediately in <1.4s.
Search residential and investment properties by 5-digit ZIP code (78701) or city/state (Austin, TX). Automatically normalizes bare 5-digit ZIPs (postal_code:78701) vs city strings (city:Austin, TX) across dual failover rails and computes AVM instant equity & gross cap-rate metrics. Cost: 2 Credits per property returned (0 Credits if empty).
Parameters
locationstringrequired5-digit US ZIP code (e.g.
78701,90210) orCity, ST(e.g.Austin, TX,Miami, FL).Example:
78701statusstringListing status filter:
for_sale(default),for_rent, orsold.pageinteger (1 to 100)Page number (1-100).
limitinteger (1 to 50)Maximum properties returned per page (1-50, default 20).
Example Request (cURL / Python / JavaScript)
curl "https://api.realtydataapi.com/v1/properties/search?location=78701" \
-H "x-api-key: rl_live_your_api_key"import requests
res = requests.get(
"https://api.realtydataapi.com/v1/properties/search?location=78701",
headers={"x-api-key": "rl_live_your_api_key"},
timeout=30,
)
print(res.json())const res = await fetch("https://api.realtydataapi.com/v1/properties/search?location=78701", {
headers: { "x-api-key": "rl_live_your_api_key" },
});
const data = await res.json();
console.log(data);Live Response Preview
{
"code": 0,
"provider": "https://realtydataapi.com",
"status": "ok",
"data": {
"location": "78701",
"normalized_query": "postal_code:78701",
"listing_status": "for_sale",
"page": 1,
"limit": 20,
"count": 20,
"total_available": 184,
"properties": [
{
"property_id": "8241233717",
"mls_id": "ACT9841204",
"status": "for_sale",
"property_type": "single_family",
"formatted_address": "901 W 9th St, Austin, TX 78701",
"city": "Austin",
"state_code": "TX",
"postal_code": "78701",
"list_price": 649000,
"estimated_value": 668400,
"instant_equity": 19400,
"instant_equity_pct": 2.99,
"price_per_sqft": 312,
"estimated_monthly_rent": 3850,
"gross_cap_rate_pct": 7.12,
"beds": 4,
"baths": 3,
"sqft": 2080,
"lot_sqft": 7840,
"year_built": 2019,
"days_on_market": 14,
"hoa_fee_monthly": 45,
"annual_property_tax": 8420,
"school_rating_avg": 9,
"photo_count": 37
}
]
},
"meta": {
"request_id": "req_rl_78701_9a2f",
"endpoint": "/v1/properties/search",
"credits_charged": 40,
"cached": true,
"took_ms": 28
}
}Response Fields
Normalized MLS property listings with AVM valuation & cap-rate indicators.
| Field | Type | Sample / Notes |
|---|---|---|
code | integer | Example: 0 |
provider | string | Example: https://realtydataapi.com |
status | string | Example: ok |
data | object | |
location | string | Example: 78701 |
normalized_query | string | Example: postal_code:78701 |
listing_status | string | Example: for_sale |
page | integer | Example: 1 |
limit | integer | Example: 20 |
count | integer | Example: 20 |
total_available | integer | Example: 184 |
properties | array of PropertyItem | |
property_id | string | Example: 8241233717 |
listing_id | string | Example: 2994810221 |
mls_id | string | Example: ACT9841204 |
status | string | Example: for_sale |
property_type | string | Example: single_family |
formatted_address | string | Example: 901 W 9th St, Austin, TX 78701 |
street | string | Example: 901 W 9th St |
city | string | Example: Austin |
state_code | string | Example: TX |
postal_code | string | Example: 78701 |
county | string | Example: Travis |
latitude | number | Example: 30.2729 |
longitude | number | Example: -97.7512 |
list_price | number | Example: 649000 |
estimated_value | number | Example: 668400 |
instant_equity | number | Example: 19400 |
instant_equity_pct | number | Example: 2.99 |
price_per_sqft | number | Example: 312 |
estimated_monthly_rent | number | Example: 3850 |
gross_cap_rate_pct | number | Example: 7.12 |
beds | number | Example: 4 |
baths | number | Example: 3 |
sqft | number | Example: 2080 |
lot_sqft | number | Example: 7840 |
year_built | integer | Example: 2019 |
days_on_market | integer | Example: 14 |
hoa_fee_monthly | number | Example: 45 |
annual_property_tax | number | Example: 8420 |
school_rating_avg | number | Example: 9 |
primary_photo | string | Example: https://ap.rdcpix.com/sample-austin-78701.jpg |
photo_count | integer | Example: 37 |
photos | array of string | |
meta | ResponseMeta | |
request_id | string | Example: req_rl_78701_9a2f |
endpoint | string | Example: /v1/properties/search |
credits_charged | integer | Example: 40 |
cached | boolean | Example: true |
took_ms | integer | Example: 28 |
Status Codes
- 200
- Normalized MLS property listings with AVM valuation & cap-rate indicators.