按经纪人 ID 查询挂牌房源组合
查看全部 Realtor 美国房产数据 API →传入经核对的经纪人搜索结果中的 fulfillmentId。可选 status 文档值包括 for_sale、for_rent、off_market、sold、ready_to_build、other，并列出逗号分隔组合；limit 与 page 可选。本接口未实测，房源字段、状态筛选、分页和组合完整性均未确认。展示前需核对返回身份和状态，不能把单次结果视为该经纪人的全部库存或交易历史。
API 功能
fulfillment 键查询挂牌组合 本接口必填 fulfillmentId，不以经纪人 profileId 代替。
经纪人房源状态组合输入 文档允许在售、出租、已售等状态及逗号组合，实际效果仍需核验。
挂牌组合分页与条数参数 可测试 limit 和 page，但不能预设分页可靠或结果完整。
限定为观察到的组合快照 实际结果只代表待验证的观测，不证明覆盖全部库存或历史交易。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/realtor/agents-listings API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realtor/agents-listings?key=<API_KEY>&fulfillmentId=<fulfillmentId>'
curl -X GET 'https://api.opendata-api.com/api/project/realtor/agents-listings?key=<API_KEY>&fulfillmentId=<fulfillmentId>'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为选定经纪人的房源组合评估在售、出租与已售分类页。
- 在经纪业务研究中，比较人工选定经纪人群体的已观察房源。
- 将逗号分隔状态组合与分别查询的状态结果进行测试对照。
- 保存带日期的挂牌组合观测，并向分析人员明确不完整性。
常见问题
经纪人挂牌查询应该传 profileId 还是 fulfillmentId？
本接口要求 fulfillmentId。请先从经核对的经纪人列表取得，不能把用于资料页的 profileId 直接替换进来。
可以同时查询在售和出租房源吗？
文档列出逗号组合，例如 for_sale,for_rent，但本接口尚未实测。上线前需分别验证组合和单独状态的返回行为。
返回列表是否就是该经纪人的全部成交和库存？
不是完整性保证。字段、分页和覆盖未确认，应记录查询时间、核对身份，并把结果标注为观察到的挂牌组合。