按旧版筛选条件查询已售房源(已弃用)
查看 美国房产与房贷数据 API 的全部接口 →通过已弃用的接口查询已售住宅房源记录。请求要求提供 city、state_code、limit 和 offset。可选筛选条件包括价格、房龄、房屋面积、地块面积、房产类型、以英里为单位的搜索半径、邮政编码、经纬度边界以及排序方式。prop_type 支持用英文逗号分隔多个文档列出的类型:single_family、condo、mobile、multi_family、farm 和 land。offset 表示分页时跳过的记录数,不是页码。 位置参数的文档限制需要特别留意:postal_code 不能与 city 或 state_code 同时使用;只要 postal_code、city 或 state_code 中任一参数有值,经纬度边界就不生效。但当前请求约定仍要求填写 city 和 state_code,因此不能认定此接口支持仅按邮编或仅按经纬度边界查询。应保留这些约束,不要擅自省略必填参数。sort 的说明列出 price_low 和 price_high,示例却使用 relevance;该示例是否被接受尚未验证。文档没有给出 limit 的上限,也未完整说明排序行为。 此接口暂无实测响应记录。现有响应示例已截断且未经验证。可见的 listings 数组包含 property_id、listing_id、prop_status、prop_type、sold_date、list_date、last_update、address、结构化地址 address_new、经纬度、beds、baths、photo 和 photo_count。示例还区分用于展示的格式化 price、sqft 与原始值 price_raw、sqft_raw。这些字段不代表当前接口保证返回的数据结构。价格筛选条件和 price_raw 本身都不能证明价格是经核实的实际成交价。审查或迁移历史已售房源查询时,应记录请求日期及候选房产标识。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/properties-list-sold-deprecated API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-list-sold-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'
查询结果
使用场景
- 调整接入方式前,审查已保存的城市与州已售住宅查询,核对价格、房龄、地块面积和房屋面积筛选条件。
- 记录请求日期、limit、offset 及选取的房产和挂牌标识,复现旧版已售房源的分页查询。
- 检查旧版地图搜索表单,识别因请求同时提供必填城市与州参数而不生效的经纬度边界。
- 迁移展示 sold_date、格式化价格和面积的已售结果表格,保留展示值与原始值的区分,避免将价格标为经核实的成交价。
- 迁移已售房源搜索时,分别测试文档列出的房产类型组合、价格排序值与未经验证的 relevance 示例。
常见问题
这个已弃用的已售住宅查询接口需要哪些必填参数?
city、state_code、limit 和 offset 均为必填项,文档示例依次为 New York City、NY、200 和 0。添加可选筛选条件不会免除这些必填要求。
可以只用邮政编码或经纬度边界查询吗?
当前请求约定不能确认支持这两种用法。位置参数说明指出,postal_code 不应与 city 或 state_code 同时使用;只要这些位置字段中任一字段有值,经纬度边界就会被忽略。由于 city 和 state_code 在此仍为必填项,不应假设支持仅按邮编或仅按边界查询。
limit 和 offset 如何控制分页?
limit 表示希望获取的记录数,offset 表示要跳过的记录数。例如 offset 为 0 时不跳过记录,并非指第 0 页。文档没有给出 limit 上限,也不保证排序稳定或返回完整结果。
文档列出了哪些房产类型和排序值?
prop_type 支持 single_family、condo、mobile、multi_family、farm 和 land,多种类型以英文逗号分隔。sort 的说明列出 price_low 和 price_high,另有示例使用 relevance,但暂无实测记录确认该示例是否被接受。
返回的价格就是经过核实的实际成交金额吗?
不一定。未经验证的旧版示例包含 price、price_raw 和 sold_date,但不能据此确认价格字段或价格筛选条件采用的是经核实的交易金额。应将房源价格与通过独立渠道核实的成交价数据分开处理。
哪些已售房源响应字段已经过实际调用验证?
现有材料中没有经过实际调用验证的字段,也没有实测响应记录。已截断的示例展示了 listings 数组,其中包括标识、地址信息、状态、房产类型、日期、卧室数、浴室数、照片、价格和面积字段。设计迁移适配程序时,应将这些字段仅作为示例参考。