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

查看 美国房产与房贷数据 API 的全部接口 →

此已弃用的已售房产搜索接口要求提供 city、state_code、limit 和 offset 查询参数。city 和 state_code 应使用地点自动补全结果中的字符串;limit 是请求每页返回条数的数值,offset 是分页时跳过记录数的数值。可选数值筛选条件包括房龄、最少卧室数和卫生间数、价格、建筑面积、地块面积、经纬度边界,以及 1 至 20 英里的搜索半径。prop_type 支持文档列出的房产类型,多个值用逗号分隔;sort 支持 sold_date、beds_high、price_low、price_high 和 lot_sqft_high。 文档中的位置参数存在约束冲突:postal_code 不应与 city/state_code 同时使用,但此保留的接口约定仍将 city/state_code 列为必填项。文档还说明,只要 postal_code、city 或 state_code 有值,经纬度边界就不会生效。因此,不应承诺仅凭邮政编码或仅凭边界框即可查询。 目前没有该接口的实测响应。文档中一个未经验证且已截断的示例包含 meta.matching_rows、meta.returned_rows,以及 properties 数组;数组条目中有 property_id、listing_id、prop_status、prop_type、price、beds、baths、baths_full 和可为 null 的 baths_half。示例还包含地址字段 line、city、state_code、postal_code、lat 和 lon,带有 size 与 units 的 building_size、lot_size 对象,以及 photo_count、photos、list_date 和 last_update。这些只是文档示例中的字段,既不是已验证的响应结构,也不保证当前仍可获得。示例不能证明 price 是实际成交价,也不能证明 list_date 是交易交割日期。 此接口适合保留用于旧版迁移审查。在将结果用于估值之前,应独立核实已售状态及交易字段。

API 功能

城市与州代码定位已售候选房 保留的请求约定要求提供地点自动补全返回的 city、state_code,以及数值型 limit、offset 分页参数。
保留房龄与最低房间数条件 可选的 age_min、age_max、beds_min 和 baths_min 用于审查旧版已售房源筛选中的房龄、卧室及卫生间要求。
分别核对价格和两类面积区间 价格、建筑面积和地块面积各有独立的上下限参数;响应示例中的 building_size 和 lot_size 通过 size、units 表示面积与单位。
明确旧版已售结果排序选项 sort 支持 sold_date、beds_high、price_low、price_high 和 lot_sqft_high。示例中的 sold_date 不代表排序行为已经过独立验证。
揭示位置筛选模式的冲突 邮政编码与城市、州代码互斥,经纬度边界又受这些参数影响;同时 city/state_code 仍为必填,因此不能将这些位置模式宣传为可互换。
区分示例字段与已验证交易数据 截断的文档示例列出计数、标识、地址及房产属性字段,但没有实测结果可验证字段可用性,或证明其中价格就是实际交易金额。

在线 API 演示

GET /api/project/realty-in-us/properties-v2-list-sold-deprecated

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v2-list-sold-deprecated?key=<API_KEY>&city=<city>&limit=<limit>&offset=<offset>&state_code=<state_code>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

此已售房产搜索接口有哪些必填参数?

保留的接口约定要求提供字符串 city 和 state_code,以及数值型 limit 和 offset。文档要求 city 和 state_code 取自地点自动补全结果。示例使用每页 200 条、偏移量 0;这只是示例,不代表默认值或最大值。

可以只用邮政编码或经纬度边界框搜索吗?

保留的必填参数约定不支持这一结论。文档要求 postal_code 不与 city/state_code 同时使用,但 city/state_code 又是必填项;文档还说明,只要 postal_code、city 或 state_code 任意一项有值,经纬度边界就不生效。因此,不能假定这些可选字段可以绕过必填的城市与州代码。

文档支持哪些房产类型和排序值?

prop_type 支持 single_family、multi_family、condo、mobile、land、farm 和 other,多个值用逗号分隔。sort 支持 sold_date、beds_high、price_low、price_high 和 lot_sqft_high。现有文档未确认其他可用值。

哪些响应字段已经过实际调用验证?

此接口目前没有实测响应字段。一个未经验证且已截断的文档示例包含 meta.matching_rows、meta.returned_rows,以及 properties 中的标识、状态与类型、价格、房间数、地址、building_size、lot_size、照片字段和房源上架及更新时间。这些字段名不能证明响应结构完整,也不能保证当前仍可获得。

price 字段能证明实际成交金额吗?

不能。文档示例虽然包含 price 和 prop_status,却未说明实际交易金额。同样,list_date 也不能证明交易交割日期。将结果作为估值可比房产之前,应独立核实已售状态和交易字段。

面积与搜索半径筛选如何使用?

sqft_min 和 sqft_max 表示房产面积上下限,lot_sqft_min 和 lot_sqft_max 表示地块或土地面积上下限;简要参数说明未完整定义面积单位。radius 明确使用英里,范围为 1 至 20,但其与存在冲突的位置筛选模式如何配合,尚未验证。

新建已售房产集成时应该采用此接口吗?

不建议。此接口已标记弃用,更适合用于审查现有请求和规划迁移。应单独评估现行搜索接口,并核实其筛选条件、分页方式及已售房产响应语义,不要假定可以直接替换。

相关接口

相关指南

查看订阅方案 →