查询指定房产经纪人的推荐反馈
查看 美国房产与房贷数据 API 的全部接口 →使用必填字符串查询参数 fulfillment_id 请求指定经纪人的推荐反馈。该值取自 /agents/v2/list 所选结果的 fulfillment_id 字段,文档示例为 1365510。不要用经纪人的档案 id 替代 fulfillment_id。此接口未记载分页、排序或按推荐者筛选的参数。 现有文档示例除其他档案字段外,还包含带数值型 count 的 recommendations 对象,以及含 recommendation_rating 的 ratings 对象。这是一个不完整的档案形式示例,档案和评价接口也使用了同一示例,不能据此确定推荐条目集合的结构。现有资料未验证推荐正文、作者署名、日期、条目标识或推荐列表的外层结构。 此接口没有可用的实测响应。recommendations.count 和 ratings.recommendation_rating 仅是未经验证的示例字段,并非保证返回的响应结构,也不保证数量反映当前情况。界面上应将推荐反馈与评价分开。缺少反馈或数量字段表示信息不可用,不代表无人推荐、经纪人表现不佳,也不能据此判断执照状态或可信程度。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 后,再加载该经纪人的推荐反馈标签页。
- 在经纪人对比页中分别标注推荐反馈和评价板块,不合并两类反馈的数量或内容。
- 先核实实际返回字段,再依据 recommendations.count 试做推荐数量徽标;字段缺失时展示信息不可用。
- 检查实际结果是否包含推荐正文和署名,以判断能否展示推荐卡片,而不是根据档案形式的文档示例虚构条目。
- 在获得同意的经纪人记录中,将推荐反馈状态与执照或可信度评估分开记录,尤其不要从未返回推荐信息推导结论。
常见问题
查询推荐反馈需要哪一种经纪人标识?
需要字符串参数 fulfillment_id,其值取自 /agents/v2/list 所选结果的 fulfillment_id 字段。文档示例为 1365510;profile_id 不是此接口记载的请求参数。
推荐数量是否经过实际响应验证?
没有。不完整的文档示例包含数值型 recommendations.count 和 ratings.recommendation_rating 字段,但此接口没有可用的实测响应。在依赖这些字段之前,应先检查实际查询结果。
示例是否定义了推荐正文、作者和日期?
没有。所提供的示例是不完整的档案形式对象,其他经纪人详情接口也使用了该示例。它没有确定推荐条目列表,也没有定义正文、署名、日期或标识字段。设计推荐展示页面时,不应虚构这些字段。
可以筛选推荐反馈或分页获取吗?
文档未记载筛选、page、offset、limit 或排序参数,支持的请求参数只有 fulfillment_id。现有资料也没有确定返回推荐反馈的完整性或分页约定。
推荐反馈能与评价合并,或用于计算可信度分数吗?
不能。推荐反馈应与独立评价接口的内容分开。推荐数量或推荐数据缺失均不能确定执照状态、服务质量或可信程度;数量字段缺失时应保留未知状态,不要转换为零。