查询指定房产经纪人的推荐反馈

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

使用必填字符串查询参数 fulfillment_id 请求指定经纪人的推荐反馈。该值取自 /agents/v2/list 所选结果的 fulfillment_id 字段,文档示例为 1365510。不要用经纪人的档案 id 替代 fulfillment_id。此接口未记载分页、排序或按推荐者筛选的参数。 现有文档示例除其他档案字段外,还包含带数值型 count 的 recommendations 对象,以及含 recommendation_rating 的 ratings 对象。这是一个不完整的档案形式示例,档案和评价接口也使用了同一示例,不能据此确定推荐条目集合的结构。现有资料未验证推荐正文、作者署名、日期、条目标识或推荐列表的外层结构。 此接口没有可用的实测响应。recommendations.count 和 ratings.recommendation_rating 仅是未经验证的示例字段,并非保证返回的响应结构,也不保证数量反映当前情况。界面上应将推荐反馈与评价分开。缺少反馈或数量字段表示信息不可用,不代表无人推荐、经纪人表现不佳,也不能据此判断执照状态或可信程度。

API 功能

按 fulfillment_id 定位推荐反馈 使用经纪人搜索结果中的 fulfillment_id 指定查询对象;该参数为必填字符串,不能以档案标识代替。
独立展示经纪人推荐意见 为推荐反馈标签页发起专门请求,不将评价内容直接当作可互换的推荐意见。
推荐数量示例字段说明 不完整的文档示例包含数值型 recommendations.count,但当前响应是否包含该字段及其含义仍需验证。
推荐条目展示的结构边界 现有档案形式示例没有确定推荐正文、作者和日期,不能据此假定已具备构建推荐卡片所需的数据。
区分推荐信息未知与数量为零 推荐数据缺失时保留不可用状态,不编造零条推荐,也不将缺失信息转化为对经纪人的负面判断。

在线 API 演示

GET /api/project/realty-in-us/agents-v2-get-recommendations

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

查询推荐反馈需要哪一种经纪人标识?

需要字符串参数 fulfillment_id,其值取自 /agents/v2/list 所选结果的 fulfillment_id 字段。文档示例为 1365510;profile_id 不是此接口记载的请求参数。

推荐数量是否经过实际响应验证?

没有。不完整的文档示例包含数值型 recommendations.count 和 ratings.recommendation_rating 字段,但此接口没有可用的实测响应。在依赖这些字段之前,应先检查实际查询结果。

示例是否定义了推荐正文、作者和日期?

没有。所提供的示例是不完整的档案形式对象,其他经纪人详情接口也使用了该示例。它没有确定推荐条目列表,也没有定义正文、署名、日期或标识字段。设计推荐展示页面时,不应虚构这些字段。

可以筛选推荐反馈或分页获取吗?

文档未记载筛选、page、offset、limit 或排序参数,支持的请求参数只有 fulfillment_id。现有资料也没有确定返回推荐反馈的完整性或分页约定。

推荐反馈能与评价合并,或用于计算可信度分数吗?

不能。推荐反馈应与独立评价接口的内容分开。推荐数量或推荐数据缺失均不能确定执照状态、服务质量或可信程度;数量字段缺失时应保留未知状态,不要转换为零。

相关接口

相关指南

查看订阅方案 →