美国地点联想补全
查看 Redfin 美国房产数据 的全部接口 →美国房产地理的输入联想解析。传入任意自由文本片段（城市、邮编、社区、学区、楼宇或地址），返回 data.exactMatch 与 data.rows：每行带 id（区域标识，如纽约为 6_30749）、type、name、subName（'New York, NY, USA' 规范形式）、url（如 /city/30749/NY/New-York）、searchType（Places、Schools、Agents 或 Buildings）与 countryCode。rows[].id 可直接串联区域搜索接口，rows[].subName 可串联地点搜索接口。地点无匹配时仍返回 HTTP 200，但 hasFakeResults=true 且带哨兵行 id 23_null（searchType 为 'Search On Map'），把结果当真实地点使用前请先检查 hasFakeResults。
API 功能
区域 ID 供搜索串联 exactMatch 与每行结果都带 id 标识（type_regionId 形式，如 6_30749），正是区域搜索接口所需的入参。
规范地名输出 subName 把杂乱输入归一成地点搜索接口接受的 'City, ST, USA' 形式。
混合结果类型 一次调用覆盖城市、邮编、社区、学区、楼宇与经纪人市场，每行附 searchType 标签。
明确的无匹配信号 无法识别的文本返回 hasFakeResults=true 与 23_null 哨兵行而非报错，表单可据此展示干净的无结果状态。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/redfin/property-auto-complete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/redfin/property-auto-complete?key=<API_KEY>&location=New+York'
curl -X GET 'https://api.opendata-api.com/api/project/redfin/property-auto-complete?key=<API_KEY>&location=New+York'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 为搜索框做边输边联想的地点选择器，返回真实城市、邮编、社区与地址。
- 把用户输入的地名规范成 'City, ST, USA' 形式后再执行房源搜索。
- 取出 exactMatch.id 直接喂给按区域的在售、出租或已售搜索。
- 识别 hasFakeResults=true 的响应，展示无此地点提示而不是空房源列表。
常见问题
Redfin 有官方 API 吗？没有官方接口怎么获取数据？
Redfin 早已关闭公开开发者接口。本项目把官网同款的地点、搜索与详情数据整理成稳定的 JSON 接口，一次认证调用即可拿到结果，不用自己维护爬虫与代理池。
怎么把城市名转换成搜索接口需要的区域 ID？
把城市片段传给 location，从返回的 exactMatch.id 或 rows[].id 取出形如 6_30749 的区域标识，直接作为区域搜索接口的 regionId 入参。
查不到的地点会报错吗？
不会报错。无匹配时返回 hasFakeResults=true，并带一行 id 为 23_null、searchType 为 'Search On Map' 的哨兵结果。请先判断该标志，再决定是否把行当真实地点使用。