Skip to content
Realtor.com

Search listings

One page of a realtor.com search, 42 homes for sale or sold, as the page shows them, with the MLS's wishes on AI use.

realtor/listings/search21 credits a callv1.2.0

When to use it

You need the homes of a realtor.com search (United States): price, beds, baths, surfaces, address and coordinates, status (for sale, pending, sold, a plan to build), listing date, photos, tours, open house, the brokerage or the builder, the contact line, and the listing's MLS and ids. Set the search up on realtor.com (place, filters, sort), then pass its URL; next gives the following page. A listing's MLS may ask that it not be given to AI: every listing comes with that wish in ai_distribution_suppressed, and honouring it is the caller's responsibility.

Try it

The options on the left write the call; the answer on the right is the contract's example. With your API key, the same call returns live data.

1Request
A realtor.com search of homes for sale or sold, exactly as the browser shows it once set up: the place, then its filters as the page writes them in the path (beds-3, price-300000-600000, type-condo, show-recently-sold, sby-6 for newest first), its page the page to start at (pg-2 is the second page).
Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor).
21 credits a call
Code, from the fields above
curl https://api.lobstr.io/v2/run \
  -H "Authorization: Bearer $LOBSTR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "realtor",
    "operation": "listings/search",
    "options": {
      "url": "https://www.realtor.com/realestateandhomes-search/Austin_TX"
    }
  }'
2Response

An example answer, from the contract. Run it on your own input with your API key.

{
  "object": "run",
  "id": "run_vbd3drut6y7zbogwhqd7kjq4nu",
  "livemode": true,
  "source": "realtor",
  "operation": "listings/search",
  "version": "1.2.0",
  "schema_url": "https://api.lobstr.io/v2/catalog/realtor/listings/search",
  "options": {
    "url": "https://www.realtor.com/realestateandhomes-search/Austin_TX"
  },
  "fields": null,
  "status": "succeeded",
  "count": 1,
  "has_more": true,
  "next": {
    "source": "realtor",
    "operation": "listings/search",
    "options": {
      "url": "https://www.realtor.com/realestateandhomes-search/Austin_TX",
      "cursor": "gAAAAABpNWd0x2kQ8vZr3TfYc1LmRb7uHsE9wA4jXoKqDn6yPiGt5"
    }
  },
  "cost": {
    "credits": 21
  },
  "results": [
    {
      "object": "listing",
      "id": "9229990651",
      "position": 1,
      "url": "https://www.realtor.com/realestateandhomes-detail/9505-Buckstitch-Saddle-Dr_Austin_TX_78724_M92299-90651",
      "status": "for_sale",
      "status_label": "House for sale",
      "property_type": "single_family",
      "plan_name": null,
      "price": {
        "amount": 407775,
        "currency": "USD",
        "from": false,
        "hidden": false
      },
      "price_reduced_by": null,
      "sold_price": null,
      "beds": 4,
      "baths": 3,
      "living_area_sqft": 2298,
      "lot_sqft": 6534,
      "address": {
        "line": "9505 Buckstitch Saddle Dr",
        "unit": null,
        "city": "Austin",
        "state_code": "TX",
        "postal_code": "78724",
        "county_fips": "48453"
      },
      "location": {
        "lat": 30.32543,
        "lng": -97.5923
      },
      "listed_at": "2026-11-12T00:07:46Z",
      "photos": [
        "https://nh.rdcpix.com/example-photo.jpg"
      ],
      "photo_count": 36,
      "tours": {
        "three_d": false,
        "video": false,
        "virtual": true
      },
      "open_house": null,
      "flags": {
        "new_construction": true,
        "new_listing": true,
        "pending": false,
        "contingent": false,
        "foreclosure": false,
        "price_reduced": false,
        "plan": false,
        "to_be_built": false,
        "builder_promotion": false,
        "promoted": false,
        "spotlight": false,
        "verified": false
      },
      "builder": {
        "name": "D.R. Horton",
        "logo_url": null
      },
      "community": null,
      "brokerage": {
        "name": "D.R. Horton",
        "logo_url": null
      },
      "attribution": "Built by D.R. Horton",
      "contact": {
        "label": "Contact builder",
        "phone": {
          "number": "+18662776005",
          "as_written": "(866) 277-6005"
        }
      },
      "listing_source": {
        "type": "new_home",
        "id": "DRHB",
        "listing_id": "270-27513-275140000-0014"
      },
      "ai_distribution_suppressed": false,
      "display_suppressed": [],
      "ids": {
        "property_id": "9229990651",
        "listing_id": "2997404931",
        "plan_id": null,
        "spec_id": null,
        "community_id": null,
        "mls_listing_id": "270-27513-275140000-0014",
        "z_pals_id": null,
        "z_property_id": null
      },
      "source_url": "https://www.realtor.com/realestateandhomes-search/Austin_TX",
      "observed_at": "2026-11-13T12:00:00Z"
    }
  ]
}

Options

urlstringrequired
A realtor.com search of homes for sale or sold, exactly as the browser shows it once set up: the place, then its filters as the page writes them in the path (beds-3, price-300000-600000, type-condo, show-recently-sold, sby-6 for newest first), its page the page to start at (pg-2 is the second page). A filter realtor.com does not read is refused, never ignored. realtor.com serves the first 10,000 results of a search (238 pages): narrow it (a price range, a smaller place) for more.
cursorstring
Where to go on, from next in an answer, as it is: opaque, and only for the search it was given with (otherwise invalid_cursor). Leave it out to start at the URL's page.

Record

Each record of results, in the envelope every call returns (Run an operation).

objectstring
The kind of record: a listing, whichever site it comes from.
idstring
realtor.com's property id (9229990651); repeated in ids.property_id.
positioninteger
Its place in the search, across pages (page 2 starts at 43).
urlstring
The listing on realtor.com.
statusstring
realtor.com's status: for_sale, sold, ready_to_build (a builder's plan).
status_labelstring
The status as the card says it: House for sale, Pending, Sold, Condo for sale.
property_typestring
single_family, condos, townhomes, multi_family, coop, condop, land, mobile...
plan_namestring
A builder's plan's name (Plan 1908 Modeled); null for a home.
price.amountfloat
The asking price; null when realtor.com hides it.
price.currencystring
price.fromboolean
A starting price (a plan's: From $407,775).
price.hiddenboolean
realtor.com hides the price (sold homes in some states).
price_reduced_byfloat
The last price cut, in USD, when the card shows one.
sold_pricefloat
The sale price of a sold home, when realtor.com shows it.
bedsfloat
bathsfloat
Bathrooms, a half bath counting 0.5 (2.5).
living_area_sqftfloat
The living area, in square feet.
lot_sqftfloat
The lot, in square feet.
address.linestring
address.unitstring
Unit 1601.
address.citystring
address.state_codestring
TX.
address.postal_codestring
address.county_fipsstring
The county's FIPS code (48453, Travis).
location.latfloat
location.lngfloat
listed_atdate
When it was listed on realtor.com, UTC.
photoslist
The photos the card holds (1 to 3); the listing has photo_count.
photo_countfloat
tours.three_dboolean
tours.videoboolean
tours.virtualboolean
open_housestring
The next open house as the card says it: Open house 11/14.
flags.new_constructionboolean
flags.new_listingboolean
flags.pendingboolean
flags.contingentboolean
flags.foreclosureboolean
flags.price_reducedboolean
flags.planboolean
A builder's plan, not a built home.
flags.to_be_builtboolean
flags.builder_promotionboolean
The builder runs a promotion (a credit, a rate).
flags.promotedboolean
A placement paid on realtor.com.
flags.spotlightboolean
realtor.com's Spotlight placement.
flags.verifiedboolean
realtor.com's verified badge.
builder.namestring
builder.logo_urlstring
community.idstring
community.namestring
community.promotionslist
Its promotions by kind: flex_cash...
brokerage.namestring
brokerage.logo_urlstring
attributionstring
As the card credits it: Brokered by Cervera Real Estate Inc., Built by D.R. Horton.
contact.labelstring
The card's contact button: Contact agent, Contact builder.
contact.phone.numberstring
E.164: +18662776005.
contact.phone.as_writtenstring
listing_source.typestring
mls, or new_home for a builder.
listing_source.idstring
The MLS's or the builder feed's code (AUTX).
listing_source.listing_idstring
The listing's id in that MLS or feed.
ai_distribution_suppressedboolean
The listing's MLS asks that it not be given to AI (realtor.com's suppression flag). It is delivered as the page has it; honouring that wish is the caller's responsibility.
display_suppressedlist
What realtor.com hides of the listing at its MLS's request: address, sold_price, last_sold_price, schools, avm, foreclosure...
ids.property_idstring
ids.listing_idstring
ids.plan_idstring
ids.spec_idstring
ids.community_idstring
ids.mls_listing_idstring
ids.z_pals_idstring
realtor.com's source.z_pals_id, under its own name, when it gives one (30044001_Z000005139); the site says nothing of its meaning.
ids.z_property_idstring
realtor.com's source.z_property_id, under its own name, when it gives one (64777770); the site says nothing of its meaning.
source_urlstring
The search page these values were read from, its page included.
observed_atdate
When they were read

Errors

Its own, besides those of every call (Errors). A failed call is free.

CodeStatusWhat it means
invalid_url422This URL is not a realtor.com search this operation reads.
place_not_found422realtor.com knows no such place; write it as its search does (Austin_TX, New-York_NY, 78701).
site_challenge503realtor.com asked to prove a person is there; retry in a minute (not charged). Retryable.
site_unavailable503realtor.com did not answer in time or refused the call; retry later (not charged). Retryable.
unexpected_answer424realtor.com answered in a shape we do not read yet; we are told and fix it, and it is not charged.

Price

21 credits a call, whatever the page holds: a short last page costs a whole call. An empty page and a failed call are free. What a credit costs on each plan: Credits and pricing.

Changelog

1.2.02026-11-15
ids also holds the two ids realtor.com gives with some listings' source, z_pals_id and z_property_id, under their own names, null when it gives none.
1.1.02026-11-13
next keeps the search as it was written and goes on with cursor, opaque, as every paged operation of the API (Google's page tokens): copy next as before. The URL is no longer rewritten with the next page; its pg-N still starts at any page.
1.0.02026-11-13
First version on the API v2: one page of a realtor.com search, 42 homes for sale or sold, with price, beds, baths, surfaces, address, coordinates, status, photos, tours, open house, the brokerage or builder, the contact line, the MLS and its ids, and the MLS's wish on AI use; a filter realtor.com does not read is refused, never ignored.