查找房源搜索地点与城市 ID
查看全部 Realtor 美国房产数据 API →提交地点文本，获取用于房源搜索的地点候选。New York, NY 实测返回含 data 数组的对象；候选可见 id、full_address、area_type、city、state_code、country、centroid、counties 和可能为空的 propertyId。首个城市候选的 id 为 city:New York, NY，可作为房源搜索的地点输入，但不是 property_id 或 listing_id。成功数据本身没有 status/message 字段。不存在的地点实测返回 {"data":[]}，应视作正常的无匹配结果。limit=5 曾返回 10 条建议，需要限制展示数量时请在客户端截取，不要承诺请求条数会被严格执行。
API 功能
使用返回的地点搜索键 将候选 id 交给房源搜索，避免自行猜测城市或街区标识。
完整地址辅助地点选择 full_address、area_type、city 与 state_code 可帮助区分重名地点。
中心坐标与县级上下文 已观察到的城市候选带 centroid 和 counties，可用于解释地理范围。
保留真实空建议 未知地点返回 data:[]，不应悄悄替换城市；建议条数可在界面端另行限制。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/realtor/property-auto-complete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-auto-complete?key=<API_KEY>&location=New+York%2C+NY'
curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-auto-complete?key=<API_KEY>&location=New+York%2C+NY'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 构建地点输入提示，先展示完整地址和地点类型，再由用户选择。
- 用返回的地点 ID 与地理信息规范化已保存的房源搜索条件。
- 在本地限制建议列表长度，同时保留原始结果用于排查条数差异。
- 为未找到地点的输入展示明确提示，而不是自动换成其他城市。
常见问题
补全返回的城市 ID 能直接当 property_id 吗？
不能。候选 id 标识搜索地点，property_id 标识房产，listing_id 标识某次挂牌。应把地点 id 用作搜索输入，再从房源结果取得房产和挂牌标识。
返回 data=[] 是接口失败吗？
不一定。未知地点实测正常返回 {"data":[]}，表示没有地点建议；此数据对象没有 status/message 字段，仍需结合平台整体业务状态判断。
limit=5 为什么会出现 10 个地点建议？
实测中 limit 没有作为严格条数上限。若输入框最多展示 5 项，请在客户端限制显示数量，不要依赖该参数保证响应长度。