Realtor.com API

Realtor.com Search API

Search Realtor.com listings by location with optional price, property-type, beds/baths, listing-status, and keyword filters and get property records (price, address, beds, baths) as normalized JSON.

POST/v1/run/realtor.search
Uptime
100.00%
30d · 13 calls
Requests
13
30d
Response
23.6s
median · 30d

Try it

Make your first request

propertyTypesarray
Filter by one or more property types; omit for all types (e.g. ["single_family", "townhomes"]).
searchStatusesarray
Listing statuses to include in for_sale mode; omit for active For Sale + Ready to Build. Ignored in sold mode (e.g. ["for_sale", "pending"]).
Open in
Get a free key
Sample response
Free runs return only the first 3 results. Fund a key to get the full response.
{
  "data": {
    "items": [
      {
        "addressLine": "123 Main St",
        "baths": "example",
        "beds": 12.5,
        "city": "San Francisco",
        "createdUtc": 12.5,
        "daysOnMarket": 12.5,
        "image": "https://example.com/image.jpg",
        "latitude": 37.7749,
        "listingId": "a1b2c3d4",
        "longitude": -122.4194,
        "lotSqft": 12.5,
        "postalCode": "94107",
        "price": 19.99,
        "pricePerSqft": 19.99,
        "propertyId": "a1b2c3d4",
        "propertyType": "general",
        "sqft": 12.5,
        "state": "CA",
        "status": "for_sale",
        "title": "Example title",
        "url": "https://example.com/page",
        "yearBuilt": 2024
      }
    ]
  },
  "found": true
}
Response interface
interface RealtorSearchResponse {
  data: {
    items: {
      addressLine?: string;
      baths?: string;
      beds?: number;
      city?: string;
      createdUtc?: number;
      daysOnMarket?: number;
      image?: string;
      latitude?: number;
      listingId?: string;
      longitude?: number;
      lotSqft?: number;
      postalCode?: string;
      price?: number;
      pricePerSqft?: number;
      propertyId: string;
      propertyType?: string;
      sqft?: number;
      state?: string;
      status?: "for_sale" | "ready_to_build" | "sold" | "pending" | "contingent" | "coming_soon";
      title?: string;
      url: string;
      yearBuilt?: number;
    }[];
  } | null;
  found: boolean;
}

Full parameter and response reference - every field, type, and example for this endpoint.

Reference

Request, response, and price

Last verified 2026-09-16 · uptime and latency measured over 30d
POST /v1/run/realtor.search
curl -X POST https://api.getanyapi.com/v1/run/realtor.search \
  -H "Authorization: Bearer $ANYAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"bedsMin":4,"limit":3,"location":"Austin, TX","propertyTypes":["single_family"],"searchStatuses":["pending"]}'
FieldTypeExample value
Request body
locationstring"Austin, TX"City, ZIP code, neighborhood or state to search (e.g. Las Vegas, NV).
bathsMinintegerMinimum number of bathrooms (e.g. 2).
bedsMininteger4Minimum number of bedrooms (e.g. 3).
keywordstringFree-text keyword that must appear in the listing description (e.g. 'pool').
limitinteger3Maximum number of results to return (1-25, default 25). You are billed per result returned, so a lower limit costs less.
priceMaxintegerMaximum listing price in USD (e.g. 750000).
priceMinintegerMinimum listing price in USD (e.g. 250000).
propertyTypesarray["single_family"]Filter by one or more property types; omit for all types (e.g. ["single_family", "townhomes"]).
searchModeenumListing type to search: for_sale or sold (e.g. for_sale).
searchStatusesarray["pending"]Listing statuses to include in for_sale mode; omit for active For Sale + Ready to Build. Ignored in sold mode (e.g. ["for_sale", "pending"]).
Response
dataobjectThe result wrapper, or null when nothing matched.
data.itemsobject[]Matching Realtor.com property listing records. Populated whenever the provider has data for the entity.
data.items[].addressLinestringStreet address line of the property.
data.items[].bathsstringConsolidated bathroom count (e.g. "3.5" for three full and one half bath).
data.items[].bedsnumberNumber of bedrooms.
data.items[].citystringCity the property is in.
data.items[].createdUtcnumberUTC epoch timestamp in seconds (Unix time). Multiply by 1000 for a JS Date in milliseconds.
data.items[].daysOnMarketnumberNumber of days the listing has been on the market.
data.items[].imagestringPrimary listing photo URL.
data.items[].latitudenumberLatitude of the property in decimal degrees.
data.items[].listingIdstringRealtor.com listing id for this specific listing of the property.
data.items[].longitudenumberLongitude of the property in decimal degrees.
data.items[].lotSqftnumberLot size in square feet.
data.items[].postalCodestringPostal (ZIP) code of the property.
data.items[].pricenumberCurrent list price in US dollars.
data.items[].pricePerSqftnumberList price per square foot in US dollars.
data.items[].propertyIdstringRealtor.com property id (stable identifier for the listing). Populated whenever the provider has data for the entity.
data.items[].propertyTypestringProperty type (e.g. single_family, condos, townhomes).
data.items[].sqftnumberInterior living area in square feet.
data.items[].statestringTwo-letter state code the property is in.
data.items[].status"for_sale" | "ready_to_build" | "sold" | "pending" | "contingent" | "coming_soon"Display listing status, including ready-to-build, pending, contingent, and coming-soon sub-statuses when present.
data.items[].titlestringHuman-readable street address line used as the listing title.
data.items[].urlstringCanonical Realtor.com listing detail page URL. Populated whenever the provider has data for the entity.
data.items[].yearBuiltnumberYear the property was built.
foundbooleanTrue when the search returned at least one matching listing.
Price
Price per request (ceiling)USD$0.0468
Price /1k resultsUSD$1.80

FAQ

About the Realtor.com Search API

The AnyAPI Realtor.com Search API returns Realtor.com search data as normalized JSON from one POST call to /v1/run/realtor.search. Search Realtor.com listings by location with optional price, property-type, beds/baths, listing-status, and keyword filters and get property records (price, address, beds, baths) as normalized JSON. AnyAPI returns one normalized schema whichever source serves it. It costs $1.80 per 1,000 results, and never more than $0.0468 for a single request, in US dollars with no subscription and no monthly minimum. Over the last 30 days, 100.0% of Realtor.com search calls through AnyAPI succeeded, with a median response time of 23.6 seconds across 13 measured calls.

It costs $1.80 per 1,000 results, and never more than $0.0468 for a single request, in US dollars with no subscription and no monthly minimum. You fund one USD wallet, each call draws it down, and a failed request costs $0.

Search Realtor.com listings by location with optional price, property-type, beds/baths, listing-status, and keyword filters and get property records (price, address, beds, baths) as normalized JSON. The response is normalized JSON with the same envelope every AnyAPI endpoint returns, so parsing a second endpoint is a change of URL and nothing else.

Over the last 30 days, 100.0% of Realtor.com search calls through AnyAPI succeeded, with a median response time of 23.6 seconds across 13 measured calls. These are AnyAPI's own measurements of traffic through the gateway, recomputed continuously, not a published service-level target.