Skip to content
RealtyDataAPI
All endpoints

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.

Warm / Live p5022ms / 1,850ms (200 OK)
10K Items$0.80 – $2.00
100K Items$8.00 – $20.00
1M Items$80 – $200 · /telemetry.json

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

  • locationstringrequired

    5-digit US ZIP code (e.g. 78701, 90210) or City, ST (e.g. Austin, TX, Miami, FL).

    Example: 78701

  • statusstring

    Listing status filter: for_sale (default), for_rent, or sold.

  • 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"

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.

FieldTypeSample / Notes
codeintegerExample: 0
providerstringExample: https://realtydataapi.com
statusstringExample: ok
dataobject
locationstringExample: 78701
normalized_querystringExample: postal_code:78701
listing_statusstringExample: for_sale
pageintegerExample: 1
limitintegerExample: 20
countintegerExample: 20
total_availableintegerExample: 184
propertiesarray of PropertyItem
property_idstringExample: 8241233717
listing_idstringExample: 2994810221
mls_idstringExample: ACT9841204
statusstringExample: for_sale
property_typestringExample: single_family
formatted_addressstringExample: 901 W 9th St, Austin, TX 78701
streetstringExample: 901 W 9th St
citystringExample: Austin
state_codestringExample: TX
postal_codestringExample: 78701
countystringExample: Travis
latitudenumberExample: 30.2729
longitudenumberExample: -97.7512
list_pricenumberExample: 649000
estimated_valuenumberExample: 668400
instant_equitynumberExample: 19400
instant_equity_pctnumberExample: 2.99
price_per_sqftnumberExample: 312
estimated_monthly_rentnumberExample: 3850
gross_cap_rate_pctnumberExample: 7.12
bedsnumberExample: 4
bathsnumberExample: 3
sqftnumberExample: 2080
lot_sqftnumberExample: 7840
year_builtintegerExample: 2019
days_on_marketintegerExample: 14
hoa_fee_monthlynumberExample: 45
annual_property_taxnumberExample: 8420
school_rating_avgnumberExample: 9
primary_photostringExample: https://ap.rdcpix.com/sample-austin-78701.jpg
photo_countintegerExample: 37
photosarray of string
metaResponseMeta
request_idstringExample: req_rl_78701_9a2f
endpointstringExample: /v1/properties/search
credits_chargedintegerExample: 40
cachedbooleanExample: true
took_msintegerExample: 28

Status Codes

200
Normalized MLS property listings with AVM valuation & cap-rate indicators.