按 advertiser_id 查询经纪人评价(已弃用)

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

通过已弃用的 GET /agents/get-reviews 接口请求经纪人评价。唯一有文档说明的入参是必填的数值型 advertiser_id,该标识据文档由旧版 /agents/list 接口返回,不能用经纪人的 fulfillment_id 替代。现有 HTTP 200 示例仅为空 JSON 对象,无法据此确认评价集合、评价正文、评分、时间、作者归属或分页字段。本接口未采集到实际调用响应,空示例也不代表某位经纪人没有评价。仅建议在审计或迁移已有 advertiser_id 评价查询流程时保留此接口,并在依赖它之前核实接口可用性及响应结构。

API 功能

以 advertiser_id 定位评价请求 旧版评价请求必须使用数值型 advertiser_id,不能以经纪人姓名、邮政编码或 fulfillment_id 代替。
核对旧版目录到评价的标识传递 审查已有集成时,可依据文档核对 /agents/list 到 /agents/get-reviews 的标识传递关系;现有示例未提供含实际数据的记录来验证这一流程。
明确空对象示例的评价证据边界 提供的成功示例是 {},并非已确认的评价数组。评价正文、分数、日期及作者字段均有待验证。
限定已弃用评价接口的迁移用途 将此操作明确标记为保留的旧系统迁移接口,不承诺持续可用,也不建议将其用于新建评价产品。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

旧版评价查询需要使用哪个标识?

需要在查询参数中传入数值型 advertiser_id。文档说明该值来自旧版 /agents/list 操作。经纪人的 fulfillment_id 是另一种标识,文档未说明它可以替代 advertiser_id。

成功示例为空,是否表示经纪人没有评价?

不是。提供的 HTTP 200 示例只是一个空对象,并非本接口的实际调用响应,不能据此判断某个 advertiser_id 对应的经纪人是否有评价。

哪些评价字段可以直接依赖?

现有示例未证实任何包含实际数据的评价字段。客户端依赖评价正文、评分值、时间、评价者归属或分页信息之前,都需要先行验证。

此接口能否筛选评价或进行分页?

文档未列出筛选或分页入参,唯一明确的查询参数是 advertiser_id。不要假定支持 limit、offset 或评分筛选。

新建经纪人评价应用是否应该使用此接口?

此接口已弃用,且未进行实际调用测试。应将其用于旧系统审计或迁移,而非新评价应用的推荐基础,也不能据此承诺服务会持续可用。

相关接口

相关指南

查看订阅方案 →