按经纪人 fulfillment_id 查询关联房源
查看 美国房产与房贷数据 API 的全部接口 →通过 GET /agents/v2/get-listings 请求指定经纪人的关联房源。必须提供字符串类型的 fulfillment_id,文档说明该标识来自 /agents/v2/list,给出的入参示例和默认值均为 1365510。文档未列出房源状态、日期范围、limit 或 offset 等查询参数。本操作未采集到实际调用响应。提供的 HTTP 200 示例是一段被截断、未经验证的 JSON,其中出现的是经纪人资料,无法据此确认可用的房源集合。示例可见字段包括 fulfillment_id、fullname、bio,以及地址中的 city、country、line、postal_code、state 和 state_code;broker 与 office 含各自的身份信息,ratings 与 recommendations 含经纪人资料中的评价指标。这些仅在示例中出现的字段均不构成实际响应保证,片段也未证实房源标识、价格、房源状态、房源数组字段或分页元数据。只有在核实实际返回结构后,才应将此查询用于所选经纪人的房源展示流程;不要宣称结果是完整库存、代表当前可售状态,或能够区分在售与已售房源。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/realty-in-us/agents-v2-get-listings API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/agents-v2-get-listings?key=<API_KEY>&fulfillment_id=1365510'
查询结果
使用场景
- 确认 fulfillment_id 并验证实际房源响应结构后,在经纪人详情页增加由用户主动打开的房源面板。
- 仅为用户加入候选名单的经纪人补充查询关联房源,避免为目录中的每条结果都请求房源数据。
- 建立经纪人选择流程测试,确保房源请求传入 fulfillment_id,而非误用 advertiser_id 或门店标识。
- 在唯一成功示例只是被截断的资料片段时,通过响应契约测试防止客户端擅自假定存在房源数组、价格或分页字段。
- 将展示内容标注为经纪人的关联房源;除非另有经验证据,否则不将其称为完整库存或仅含在售房源的列表。
常见问题
查询经纪人房源所需的 fulfillment_id 从哪里获取?
文档说明,本操作使用 /agents/v2/list 返回的 fulfillment_id。请以字符串形式传入所选经纪人的标识。提供的示例及文档默认值均为 1365510,查询其他经纪人时应替换该值。
可以改用 advertiser_id 或门店 ID 吗?
文档未列出其他可用标识。本操作要求经纪人的 fulfillment_id,不能用旧版评价查询所需的 advertiser_id,也不能用 office 或 broker 内部的标识替代。
此接口的房源响应是否已经验证?
尚未采集到实际调用响应。提供的 HTTP 200 示例已被截断,其中包含 fulfillment_id、fullname、address、broker、office 和 ratings 等资料字段,不能据此确认完整响应或可用的房源集合。
能否只查询在售房源,或对房源结果分页?
文档未列出房源状态筛选、limit、offset 或其他分页入参。现有示例也未证实房源状态字段、结果总数或下一页令牌。
是否会返回该经纪人代理的全部房产?
房源完整性、更新及时性以及在售与已售房源的覆盖范围均未经验证。不要将结果展示为该经纪人的全部房源,也不要将其作为某处房产当前可售的证明。
应该为搜索结果中的每位经纪人都查询房源吗?
建议在用户选中某位经纪人或将其加入候选名单后,再明确发起查询。这既遵循文档说明的标识传递流程,也避免把未经验证的房源数据作为每条目录结果的必需补充信息。