查询指定房产经纪人的评价

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

通过必填字符串查询参数 fulfillment_id 请求指定经纪人的评价。该值来自 /agents/v2/list 所选结果的 fulfillment_id 字段,文档示例为 1365510。此请求不接受 profile_id。文档未记载评价分页、日期范围、星级筛选或排序参数。 现有文档示例是一个不完整的档案形式对象,经纪人档案、推荐反馈和评价接口均使用了这一示例。其中 ratings 对象将 reviews_count、average_rating 和 overall_rating 列为数值,而 responseCount、overall_satisfaction、performance_rating、recommendation_rating、show_scores 和 testimonial_return_rate 则显示为字符串。这些字段只是未经验证的示例,并非实际评价响应的返回保证。现有资料没有定义逐条评价的列表、评价正文、评价者姓名、评价日期、署名字段或评分尺度。 此接口没有可用的实测响应。构建评价卡片或汇总评分前,应先检查实际结果,并保留响应中确实返回的评价元数据和署名信息。不要自行推定星级尺度,也不要依据缺失字段计算分数。若实际结果明确返回空的评价集合,可标注为未获取到评价,而非评分低;响应缺失或请求失败也不能作为评价数量为零的证据。

API 功能

查询用户所选经纪人的评价 以所选目录记录的 fulfillment_id 发起评价请求,不添加文档未支持的评价者、日期或星级筛选参数。
评价数量与评分字段参考 文档示例包含 ratings.reviews_count、average_rating 和 overall_rating,但未验证评价响应是否返回这些字段,也未定义评分尺度。
兼容评价评分的混合数据类型 示例中的 responseCount 和多项满意度相关值为字符串,其他部分评分为数值;处理时应保留各字段类型,不假定所有值都是数字。
保留实际返回的评价署名 若响应返回评价条目,应保留其真实元数据与署名。现有示例没有确定评价者、正文或日期的字段名称。
中性呈现空评价与请求异常 明确为空的评价集合可显示为未获取到评价;字段缺失或请求失败应显示信息不可用,不暗示经纪人收到了负面评价。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

查询评价所需的 fulfillment_id 从哪里获取?

使用 /agents/v2/list 中所选经纪人的 fulfillment_id 字段。该参数是必填字符串,文档示例为 1365510。不要用经纪人的 id 替代,也不要向此接口传入 profile_id。

文档列出了哪些经纪人评价评分字段?

不完整的档案形式示例将 ratings.reviews_count、average_rating 和 overall_rating 列为数值,同时将 responseCount 和多项满意度相关字段列为字符串。没有可用的实际响应来确认此评价接口的结构,示例也没有定义评分尺度。

单条评价的正文、评价者和日期字段经过验证了吗?

没有。所提供的示例没有确定评价条目集合,也没有定义正文、评价者、署名或日期字段。构建评价卡片前,应检查实际响应,并保留其中确实提供的元数据和署名信息。

可以只获取近期评价或指定星级的评价吗?

文档未记载日期范围、星级、分页或排序参数,此请求仅定义了 fulfillment_id。不要假定接口支持这些筛选条件,也不要认为现有资料已证明它能提供完整评价历史。

应用应如何展示未获取到评价的经纪人?

若实际响应明确包含空的评价集合,应以中性状态显示未获取到评价。如果字段缺失或请求失败,则显示数据不可用。这两种情况都不能证明服务差、评分为零,或其他地方也不存在评价。

相关接口

相关指南

查看订阅方案 →