按经纪人 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 功能

使用所选经纪人的 fulfillment_id 沿用文档说明的 /agents/v2/list 标识传递流程,以必填的字符串 fulfillment_id 定位用户选中的经纪人。
以单一经纪人标识发起房源查询 文档仅列出一个经纪人标识入参,未提供用于调整房源结果的状态、日期范围或分页参数。
识别片段中的经纪人资料信息 被截断的成功示例含经纪人身份、地址、所属经纪机构、门店及评分信息。这些内容仅可视为未经验证的资料线索,不能作为已确认的房源结构。
先验证房源集合再展示卡片 现有片段未证实房源数组、房产标识、价格或分页字段。渲染经纪人房源卡片前,应先验证实际响应。
避免夸大经纪人房源覆盖范围 将关联房源展示与完整库存、当前可售以及在售或已售覆盖范围等说法区分开来;这些能力在此均未经验证。

在线 API 演示

GET /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 从哪里获取?

文档说明,本操作使用 /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 或其他分页入参。现有示例也未证实房源状态字段、结果总数或下一页令牌。

是否会返回该经纪人代理的全部房产?

房源完整性、更新及时性以及在售与已售房源的覆盖范围均未经验证。不要将结果展示为该经纪人的全部房源,也不要将其作为某处房产当前可售的证明。

应该为搜索结果中的每位经纪人都查询房源吗?

建议在用户选中某位经纪人或将其加入候选名单后,再明确发起查询。这既遵循文档说明的标识传递流程,也避免把未经验证的房源数据作为每条目录结果的必需补充信息。

相关接口

相关指南

查看订阅方案 →