查找经纪人搜索使用的地点
查看全部 Realtor 美国房产数据 API →提交 query 文本，可选 limit，评估经纪人目录专用地点补全。候选用于选择 agents-list 的地点输入，应检查真实返回标识后再传入。本接口尚未实测，建议字段、空结果和 limit 是否限制条数均未确认。不要假定它的地点值与 property-auto-complete 的 ID 或金融工具地点格式可互换。
API 功能
经纪人目录专用地点文本 query 是此地点建议接口的输入，不直接查询房产或金融信息。
评估地点到经纪人列表衔接 先检查实际建议标识，再将选中值用于 agents-list。
经纪人建议数量参数 limit 为可选参数，实际条数与无匹配行为未观察。
区分经纪人地点标识体系 不默认经纪人建议与房源地点或金融地点使用相同 ID。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/realtor/agents-auto-complete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realtor/agents-auto-complete?key=<API_KEY>&query=new+york'
curl -X GET 'https://api.opendata-api.com/api/project/realtor/agents-auto-complete?key=<API_KEY>&query=new+york'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 验证建议内容与标识后，搭建经纪人目录的服务地区选择器。
- 保存经纪人搜索前，区分名称相似的服务地点。
- 设置经纪人地区建议的界面上限前，测试真实条数行为。
- 独立验证经纪人地点补全到列表查询的参数衔接。
常见问题
可以直接使用房源补全返回的城市 ID 吗？
不能默认通用。经纪人地点、房源地点和金融地点属于不同输入约定，应验证实际返回值及下游兼容性。
候选里哪个字段可以传给 agents-list？
本接口尚未实测，实际标识字段未确认。先检查建议响应，再核对 agents-list 的 id 输入，不要凭名称猜测字段路径。
没有建议或 limit 未生效时如何展示？
应先验证本接口的空结果和条数行为，再设计无匹配提示与本地展示上限；不能套用房源补全的实测响应结构。