旧版经纪人房源列表查询(已弃用)

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

按旧版接口约定查询与经纪人关联的房源。此接口已弃用,仅适合维护和审查现有经纪人页面,不建议用于新接入。三个必填查询参数必须取自同一条旧版 /agents/list 结果:agent_id 为 member/id 中的数值,fulfillment_id 为 advertiser_id 中的数值,id 为 abbreviation 中的字符串。可选参数 page 用于选择页码;type 可选 all、forSale、forSold、forRent 或 openHouses。文档示例使用 page=1 和 type=all,但未明确省略参数时的行为,也未说明每页条数。现有响应文档仅提供一个未经验证的 HTTP 200 示例,内容为空 JSON 对象({})。目前没有实测响应可供参考,文档也未明确房源字段、结果总数、分页结构或错误格式。不能据此认定经纪人没有房源,也不能认定该弃用接口目前仍然可用。迁移已保存的页面前,应对照现行经纪人房源接口核实标识符要求和响应结构,不要假定不同接口的标识符可以直接互换。

API 功能

三项房源查询标识配套保留 将 agent_id、fulfillment_id 和 id 作为一组保留,分别使用旧版经纪人列表中对应的 member/id、advertiser_id 和 abbreviation 值。
五种已记录的房源类型选项 明确列出 type 的 all、forSale、forSold、forRent 和 openHouses 取值,但不承诺每种类型目前仍能返回房源。
保留历史页面的页码参数 保留已有经纪人页面使用的可选 page 参数;page=1 只是示例,不能视为已验证的默认值,也不能据此推断每页条数。
标明房源响应结构的证据缺口 提示 HTTP 200 的 {} 示例未经验证,不能据此确定房源属性、总数、分页信息或该接口当前是否可用。

在线 API 演示

GET /api/project/realty-in-us/agents-get-listings-deprecated

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-get-listings-deprecated?key=<API_KEY>&agent_id=<agent_id>&fulfillment_id=<fulfillment_id>&id=<id>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

旧版经纪人房源查询需要哪些标识符?

三个参数都必填:数值型 agent_id、数值型 fulfillment_id 和字符串型 id。旧版 /agents/list 文档将它们分别对应到 member/id、advertiser_id 和 abbreviation。请使用同一条经纪人结果中的配套值,不要通过其中一个值推导另一个值。

type 参数支持哪些已记录的房源类型?

文档列出的取值为 all、forSale、forSold、forRent 和 openHouses。此参数可选,示例使用 all,但现有资料并未确认省略时的行为,也未确认每个类别目前是否仍然可用。

这个弃用接口如何指定分页?

可通过可选的数值型 page 参数选择页码,文档示例为 1。文档没有明确每页条数、页码上限、总数字段或响应中的分页结构。

响应中有哪些可以依赖的房源字段?

现有资料尚未确认任何房源字段。唯一的文档示例标为 HTTP 200,内容仅为 {},没有房源字段。该示例未经验证,也没有实测响应,因此不能将它当成已经证实的空房源结果。

新的经纪人房源页面应该使用此接口吗?

不应该。此接口已弃用,仅供已有接入在迁移时参考。迁移已保存的页面前,请核对现行经纪人房源接口的约定,并验证标识符映射和响应字段;该旧版接口不提供自动转换或回退功能。

相关接口

相关指南

查看订阅方案 →