Find similar homes for a selected property

View all Realty in US Property & Mortgage Data endpoints →

Request similar-home candidates with GET /properties/v3/list-similar-homes. Supply the required property_id query string from the property_id field of a property-list result, not its listing_id. The optional status query string accepts one documented value: for_sale, ready_to_build, for_rent, sold, off_market, other or new_community. The optional numeric limit controls the number of items per response; 10 is the documented example, not a verified default or maximum. Only limit is exposed for response sizing on this route; no offset, page number or cursor input is documented. There is no successful response probe or source response example in the supplied evidence. Consequently, the response envelope, candidate field names, actual result count, similarity criteria, ranking and geographic scope have not been verified. Present any returned homes as suggested alternatives, verify their geography, status and property attributes before comparison, and do not treat this operation as a comparable-sales appraisal or valuation.

API Features

Selected-home recommendation lookup Start a similar-home request from the property_id of a selected search result rather than reconstructing its address or neighborhood filters.
Seven documented candidate statuses Choose one status string from for_sale, ready_to_build, for_rent, sold, off_market, other or new_community; these documented values have not been confirmed by a response probe.
Bounded related-home panel sizing Use the optional numeric limit to request a bounded candidate set. The supplied example is 10, with no verified default, maximum or guarantee of that many matches.
Suggested alternatives without appraisal claims Treat the output as candidate homes rather than verified comparables. No response schema, similarity score, ranking method or geographic radius has been established.

Live API Demo

GET /api/project/realty-in-us/properties-v3-list-similar-homes

Request cost is temporarily unavailable. No price is assumed.

View pricing

API Response (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-list-similar-homes?key=<API_KEY>&property_id=<property_id>'
📢
Need Help?
If you encounter API issues or need other API requirements, please contact us.
Contact Us

Use Cases

Frequently asked questions

How do I select the reference home for similar results?

Pass its property_id from a property-list result as the required property_id query string. The operation does not document accepting listing_id or a street address in place of that identifier.

Which status values are documented for similar-home requests?

The optional status string accepts one of for_sale, ready_to_build, for_rent, sold, off_market, other or new_community. The example is for_sale. These are documented values, not successfully probed combinations, and array or comma-separated status syntax is not documented.

Does limit 10 guarantee ten candidates or represent a default?

No. 10 is the supplied example for the optional numeric limit. The evidence does not verify a default, maximum or guaranteed candidate count. No offset, page-number or cursor request parameter is documented for this route.

What fields and similarity scores are returned?

No successful probe or response example was supplied, so candidate fields, envelope structure, similarity scores, ordering and geographic scope remain unverified. Validate the actual response before designing a fixed recommendation-card schema.

Can sold similar homes be used as a verified appraisal?

No. The documented sold status can be used to request suggested candidates, but similarity criteria and comparability have not been established. Check geography, sale status, property attributes and relevant dates independently before comparing prices.

Related operations

Guides

View Subscription Plans →