按在售、出租或已售状态统一搜索
查看全部 Realtor 美国房产数据 API →提交 location，并可选择单个 status：for_sale、for_rent 或 sold，默认 for_sale。此接口中的 page 和 pageSize 按文档保留为字符串输入。它用于评估跨市场状态的统一搜索入口，但尚未实测，响应字段也未确认。将其作为生产环境统一入口前，应分别核对状态筛选、返回地区和分页。需要已验证示例时，请使用在售、出租、已售专用搜索，不要假设它们与本接口结构完全一致。
API 功能
明确选择市场状态 单次选择在售、出租或已售，避免混用挂牌售价、租金和成交价含义。
统一地点输入评估 使用同一个 location 字段试验不同房源状态的发现页面。
字符串分页输入约定 page 和 pageSize 保留文档规定的字符串类型，实际返回条数仍需验证。
与专用搜索建立对照 以已实测的独立搜索作为参考，检查这个统一入口的响应与结果差异。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/realtor/property-search-consumer API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-consumer?key=<API_KEY>&location=New+York%2C+NY&status=for_sale'
curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-search-consumer?key=<API_KEY>&location=New+York%2C+NY&status=for_sale'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 分别验证状态后，制作在售、租房与已售切换的搜索原型。
- 对照相同地点的专用搜索结果，检查统一入口返回的房产标识。
- 评估统一查询是否保留现有房源界面需要的字段。
- 观察切换市场状态时的结果数量变化，但不合并不同含义的价格。
常见问题
status 可以同时传 for_sale 和 for_rent 吗？
此接口文档要求选择单个状态值：for_sale、for_rent 或 sold。不要把其他接口支持的逗号分隔状态组合直接用于这里。
统一搜索是否与三个专用搜索返回完全一致？
尚未确认。本接口没有实测响应字段，需分别检查各状态并与专用搜索对照，不能默认共用同一字段映射。
这里的 page 和 pageSize 是数字还是字符串？
本接口按文档使用字符串输入。其他房源搜索可能使用数字参数，集成时应保留各自类型，且仍需检查实际翻页行为。