按旧版筛选条件查询已售房源(已弃用)

查看 美国房产与房贷数据 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 功能

按城市与州检索已售记录 明确已售住宅查询必填的 city 和 state_code,同时保留文档对邮编及经纬度边界的使用限制。
分别保留房龄、面积和价格区间 审查已有已售房源查询时,逐项保留房屋面积、地块面积、房龄和价格各自的最小值与最大值条件。
组合筛选已售房产类型 prop_type 可使用单个类型,也可用英文逗号组合 single_family、condo、mobile、multi_family、farm 和 land 等文档列出的值。
以记录偏移量分页读取已售房源 用 limit 指定每次希望获取的记录数,用 offset 指定跳过的记录数;文档示例分别为 200 和 0。
区分房源展示值与原始数值 未经验证的旧版示例分别提供 price 与 price_raw、sqft 与 sqft_raw,便于旧版适配程序区分展示字符串和数值,但不能据此确认成交价的准确性。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

这个已弃用的已售住宅查询接口需要哪些必填参数?

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 数组,其中包括标识、地址信息、状态、房产类型、日期、卧室数、浴室数、照片、价格和面积字段。设计迁移适配程序时,应将这些字段仅作为示例参考。

相关接口

相关指南

查看订阅方案 →