旧版经纪人推荐评价查询(已弃用)

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

通过经纪人的广告主标识查询其旧版推荐评价资源。此接口已弃用,仅供维护现有推荐评价组件及规划迁移时参考,不建议用于新接入。唯一必填的查询参数是数值型 advertiser_id,取自目标经纪人在旧版 /agents/list 结果中的 advertiser_id 字段。文档没有列出分页或筛选参数。现有资料仅有一个标为 HTTP 200 的响应示例,内容为空 JSON 对象({});该示例未经验证,且没有实测响应可供参考。文档未明确推荐评价正文、作者署名、日期、评分、条数、结果排序或错误字段。不能把该示例当成推荐评价数量为零的证明,也不能据此保证接口目前仍然可用;此外,不应将这项资源理解为推荐经纪人搜索结果或经过验证的评分数据。若计划迁移到以 fulfillment_id 为标识的现行推荐评价接口,应明确核实经纪人身份和各项标识映射,不能直接将 advertiser_id 等同于 fulfillment_id。

API 功能

以广告主标识定位推荐评价 保留经纪人旧版推荐评价资源所需的唯一必填数值型查询参数 advertiser_id。
推荐评价组件的内容来源追溯 审查旧组件迁移方案时,保留缓存推荐评价内容与原始 advertiser_id 之间的对应关系,便于追溯。
界定推荐评价结构的已知范围 明确唯一未经验证的示例仅为 {},不足以确认推荐评价正文、作者、日期、评分、条数或排序字段。
切换 fulfillment_id 前专项核对 规划迁移到以 fulfillment_id 查询的现行推荐评价接口时,明确验证经纪人身份,不自动替换标识符。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

查询旧版经纪人推荐评价需要哪个标识符?

需要提供数值型查询参数 advertiser_id。文档说明它取自目标经纪人在旧版 /agents/list 结果中的 advertiser_id 字段。此接口没有记录其他查询参数。

这个接口能为房产搜索查找值得推荐的经纪人吗?

文档说明的用途是按 advertiser_id 查询某位经纪人的推荐评价,而不是搜索或排名推荐经纪人。现有示例也未明确推荐评价条目的格式或排序含义。

文档中的响应是否提供推荐评价正文、作者、日期或评分?

这些字段均未得到确认。唯一的文档示例标为 HTTP 200,内容是 {},且没有实测响应。因此不能据此假定会返回推荐评价列表、评分、条数或展示顺序。

空对象示例是否表示经纪人没有推荐评价?

不是。它只是未经验证的文档示例,并非实际观测到的推荐评价数量。它既没有明确空结果规则,也不能确认接口当前是否可用,因此不应将其对外发布为“推荐评价数量为零”的结论。

旧版 advertiser_id 能原样传给使用 fulfillment_id 的现行推荐评价接口吗?

现有资料没有确认这种映射。请先核实经纪人身份与目标接口的要求,再将已经验证的标识对照关系和缓存内容来源记录保留在迁移资料中。

相关接口

相关指南

查看订阅方案 →