查询指定房产经纪人的评价
查看 美国房产与房贷数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 购房者正在比较两三位经纪人时按需获取其评价,而不是批量复制整个经纪人目录的反馈。
- 在所选经纪人的评价阅读面板中保留实际条目的元数据和署名,不编造评价者姓名或发布日期。
- 为明确为空的评价集合、评价字段缺失和请求失败分别设计界面状态,避免将任何一种情况展示为低评分。
- 添加对比评分摘要前,验证返回的 ratings.reviews_count 和各评分字段类型,避免未经依据换算成五星分数。
- 先检查实际响应是否具有日期字段,再评估能否构建评价时间线,因为文档示例没有给出评价条目的日期结构。
常见问题
查询评价所需的 fulfillment_id 从哪里获取?
使用 /agents/v2/list 中所选经纪人的 fulfillment_id 字段。该参数是必填字符串,文档示例为 1365510。不要用经纪人的 id 替代,也不要向此接口传入 profile_id。
文档列出了哪些经纪人评价评分字段?
不完整的档案形式示例将 ratings.reviews_count、average_rating 和 overall_rating 列为数值,同时将 responseCount 和多项满意度相关字段列为字符串。没有可用的实际响应来确认此评价接口的结构,示例也没有定义评分尺度。
单条评价的正文、评价者和日期字段经过验证了吗?
没有。所提供的示例没有确定评价条目集合,也没有定义正文、评价者、署名或日期字段。构建评价卡片前,应检查实际响应,并保留其中确实提供的元数据和署名信息。
可以只获取近期评价或指定星级的评价吗?
文档未记载日期范围、星级、分页或排序参数,此请求仅定义了 fulfillment_id。不要假定接口支持这些筛选条件,也不要认为现有资料已证明它能提供完整评价历史。
应用应如何展示未获取到评价的经纪人?
若实际响应明确包含空的评价集合,应以中性状态显示未获取到评价。如果字段缺失或请求失败,则显示数据不可用。这两种情况都不能证明服务差、评分为零,或其他地方也不存在评价。