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.0When 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.
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" } }'
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
urlstringrequiredcursorstringnext 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).
objectstringidstringpositionintegerurlstringstatusstringstatus_labelstringproperty_typestringplan_namestringprice.amountfloatprice.currencystringprice.frombooleanprice.hiddenbooleanprice_reduced_byfloatsold_pricefloatbedsfloatbathsfloatliving_area_sqftfloatlot_sqftfloataddress.linestringaddress.unitstringaddress.citystringaddress.state_codestringaddress.postal_codestringaddress.county_fipsstringlocation.latfloatlocation.lngfloatlisted_atdatephotoslistphoto_countfloattours.three_dbooleantours.videobooleantours.virtualbooleanopen_housestringflags.new_constructionbooleanflags.new_listingbooleanflags.pendingbooleanflags.contingentbooleanflags.foreclosurebooleanflags.price_reducedbooleanflags.planbooleanflags.to_be_builtbooleanflags.builder_promotionbooleanflags.promotedbooleanflags.spotlightbooleanflags.verifiedbooleanbuilder.namestringbuilder.logo_urlstringcommunity.idstringcommunity.namestringcommunity.promotionslistbrokerage.namestringbrokerage.logo_urlstringattributionstringcontact.labelstringcontact.phone.numberstringcontact.phone.as_writtenstringlisting_source.typestringlisting_source.idstringlisting_source.listing_idstringai_distribution_suppressedbooleandisplay_suppressedlistids.property_idstringids.listing_idstringids.plan_idstringids.spec_idstringids.community_idstringids.mls_listing_idstringids.z_pals_idstringsource.z_pals_id, under its own name, when it gives one (30044001_Z000005139); the site says nothing of its meaning.ids.z_property_idstringsource.z_property_id, under its own name, when it gives one (64777770); the site says nothing of its meaning.source_urlstringobserved_atdateErrors
Its own, besides those of every call (Errors). A failed call is free.
| Code | Status | What it means |
|---|---|---|
invalid_url | 422 | This URL is not a realtor.com search this operation reads. |
place_not_found | 422 | realtor.com knows no such place; write it as its search does (Austin_TX, New-York_NY, 78701). |
site_challenge | 503 | realtor.com asked to prove a person is there; retry in a minute (not charged). Retryable. |
site_unavailable | 503 | realtor.com did not answer in time or refused the call; retry later (not charged). Retryable. |
unexpected_answer | 424 | realtor.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-15ids 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-13next 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