Redfin 美国房产数据 APIs

美国房产地理的输入联想解析。传入任意自由文本片段（城市、邮编、社区、学区、楼宇或地址），返回 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。

查询某个区域内的实时在售房源。传入地点补全返回的 regionId（6_30749 = 纽约，已实测），再叠加价格、卧室、浴室、面积、地块、建成年份、层数、车库、学校评分、步行/公交/骑行指数、HOA 费、房产税等筛选，以及 status、listingType、timeOnRedfin、priceReduced、openHouse、pool、acceptedFinancing、booleanFilters 等编码筛选和 page/limit 翻页（单页最多约 350 条）。成功响应带 status_code 200、resultsPerPage 与 data 数组；每行 homeData 含 propertyId、listingId、url、propertyType、beds、baths、priceInfo.amount、sqftInfo.amount、lotSize、yearBuilt、daysOnMarket.listingAddedDate、图片区间与 addressInfo，propertyId/listingId 配对即所有房产详情接口的钥匙。

查询某个区域内的当前在租房源。传入地点补全返回的 regionId，再叠加租金、卧室/浴室、面积、楼型、学校评分、步行/公交/骑行指数、入住日期与设施筛选（booleanFilters 如 dogs_allowed、is_furnished、utilities_included），以及 page/limit 翻页。返回行的 homeData 含 propertyId、url、propertyType、addressInfo、图片区间、促销徽章（如免租优惠）；公寓楼还带 rentalExtension 的 bedRange/bathRange 户型区间。

查询某个区域内的已成交可比房源。传入地点补全返回的 regionId、soldWithin 时间窗（7、30、90、180、365、730、1095 或 1825 天），再叠加价格、面积、地块、建成年份、泳池、贷款、HOA 费、房产税、学校评分与指数筛选。返回行与在售搜索共用 homeData 结构（propertyId、url、beds、baths、sqftInfo、lotSize、addressInfo），成交结果可干净地关联到实时挂牌数据做 comp 分析。

围绕自由文本地点查询实时在售房源：规范城市串（'New York, NY, USA'）、邮编、学区名、街道地址、区域 ID 或 Redfin 链接均可，建议先用地点补全归一输入。支持完整在售筛选集（价格、卧室、浴室、面积、地块、年份、HOA、房产税、指数、status、listingType、timeOnRedfin、priceReduced、openHouse、pool、acceptedFinancing、booleanFilters、keyword）与 page/limit 翻页。响应带 status_code、resultsPerPage 与 homeData 数组，含 propertyId 与 listingId 供详情查询。

围绕自由文本地点（城市、邮编、学区、地址、区域 ID 或 Redfin 链接）查询当前在租房源。已对 'New York, NY, USA' 实测：响应返回 status_code 200、resultsPerPage 与 data 数组，homeData 行含 propertyId、url、propertyType、addressInfo、图片区间、促销徽章，公寓楼还带 rentalExtension 的 bedRange/bathRange 户型区间。可按租金区间、卧室、浴室、面积、入住日期、学校评分、步行/公交/骑行指数与 dogs_allowed、utilities_included、has_short_term_lease 等设施标志筛选。

围绕自由文本地点（城市、邮编、学区、地址、区域 ID 或 Redfin 链接）查询已成交可比房源。用 soldWithin 时间窗（7 天到 5 年）叠加价格、面积、地块、年份、泳池、贷款、HOA、房产税、学校评分与指数筛选，组出干净的 comp 集。结果沿用 homeData 结构（propertyId、url、beds、baths、sqftInfo、lotSize、addressInfo），可直接与在售及详情数据关联。

把手工调好的 Redfin 搜索链接转成结构化 JSON。粘贴用户在网站上精心配置的完整链接（例如带站内筛选与分页路径的城市公寓出租页），拿回对应的结果行，而不是去抓渲染后的 HTML。适合镜像收藏搜索：链接里编码的范围、挂牌类型、页码都会在服务端重放并作为房源数据返回。

一次调用拿到完整房产档案。location 参数接受 propertyId（已实测：40775351）、短路径（/NY/Brooklyn/8707-Avenue-B-11236/home/40775351）、完整 Redfin 链接、街道地址或地址 slug。已验证响应返回 message 'Successful' 与一个大 data 对象：initialInfo（propertyId、listingId、marketId、latLong、hasAvm、preloadImageUrls）、aboveTheFold.addressSectionInfo.priceInfo（当前价格）及其余详情分区，单文档约 267 KB。这是把粘贴链接解析成 propertyId/listingId 键的最快路径，供各专项详情接口使用。不存在的 propertyId 目前直接表现为 HTTP 500，该路由请把 5xx 当未找到信号。

按地址 slug 或链接做轻量挂牌查询（如 5065-Eloy-St-78521，或完整挂牌链接）。多个房产共用同一地址时，传可选 propertyId 锁定精确目标。可把它当作完整 v2 详情前的廉价存在性与身份检查：先确认地址映射到在挂房产并拿到 propertyId，再决定是否调用更重的详情、估值与历史接口。

把分享出来的 Redfin 房源链接变成结构化房产数据。按从浏览器、邮件或消息里原样复制的完整链接传入，返回该房源的详情记录。适用于用户以链接而非地址或 ID 提供房源的场景：机器人、书签导入器与监控列表工具无需自己解析 URL，就能把链接展开成价格、卧室、浴室与图片预览。

Redfin Estimate 自动估值，以任意搜索响应（homeData）或 v2 详情提供的 propertyId/listingId 配对为键。把它当作与搜索里的实时要价、已售接口里的成交 comp 并列的模型参考价：估值回答模型认为它值多少，这是要价与过时成交价都回答不了的。

单套房产的持有时间线：已记录的成交事件与税务/评估历史，以 propertyId/listingId 为键。成交搜索回答邻居们付了多少钱，本接口回答这套房自己经历过什么——每一次已记录的成交、价格与评估周期。用它画升值曲线、发现快速转售，并把估值锚定在标的房产自身的记录上。

挂牌自己的叙述与事实面板：经纪人撰写的描述加上结构化的关于本房亮点，以 propertyId/listingId 为键。描述文本能浮现结构化筛选项漏掉的特征（翻新、ADU、景观、户型说明），适合做关键词挖掘、内容生成与挂牌质量审计的输入。

挂牌的设施级明细：HOA 费与包含项、停车、洗衣、制冷、供暖、家电等居家特征，以 propertyId/listingId 为键。这些是网站特征清单背后的字段——喂给细粒度搜索筛选、推荐向量或数据质量审计，补足结构化搜索结果不带的信息。

服务该房产的学校及其评分，以 propertyId/listingId 为键：划片小学、初中、高中与学区上下文。学校质量是美国房价最强的驱动因子之一；本接口把一套挂牌变成它的招生片区档案，无需独立数据集即可按学校评分排名、筛选与告警。

房产的步行指数、公交指数与骑行指数，以 propertyId/listingId 为键。这些 0-100 的步行友好度指标一眼回答无车宜居问题，也是城市市场里已被验证的租金与价格差异因子。无需单独订阅评分服务，即可加进房源卡片、筛选阈值或社区研究。

地块级气候灾害数据：房产的洪水、火灾、高温与大风风险评分。全部五个入参来自地块标识接口——lat/lng（其 latLong）、fipsCode、apn 与 parcelLid——所以先调 parcel-info，再把返回的标识传到这里。面向保险报价、买家风险报告与组合级灾害筛查设计。

房产的县地块记录键：APN（评估地块号）、FIPS 代码、parcelLid 与精确经纬度，由 propertyId 解析。除 GIS 与评估数据关联外，这也是调气候风险接口前的必需步骤——气候接口的全部入参（lat、lng、fipsCode、apn、parcelLid）都来自本响应。

挂牌的买家关注指标，以 listingId 为键：量化这套房当前吸引多少需求的浏览与收藏计数。每天跟踪这些计数，可在出价前评估竞争烈度、在价格变动前察觉势头变化，并按社区构建市场温度指数。

挂牌的价格轨迹，以 listingId 为键：带日期与金额的降价（及其他价格事件）。把变动节奏与在售天数结合可评估卖家动机，驱动即时降价提醒机器人，并在谈判前研究一个市场内降价幅度的分布。

与指定挂牌相似的房源，以 propertyId/listingId 为键：即访客在房产页看到的推荐集。用它驱动你可能也喜欢推荐栏、用邻近社区的近似房源扩充买家监控列表，或在为标的房准备报价时组装实时可比。

挂牌的看房活动，以 propertyId/listingId 为键：该房产的看房兴趣趋势。看房需求是早期预警信号——看房活动上升通常先于竞价压力与快速成交，因此是市场温度指数与经纪人优先级排序的强输入。

挂牌的看房排期日历，以 listingId 为键：买家可选的看房日期与时段。用于自动化预约看房、盯着热门房源的新开放档期；档期稀缺本身也是需求信号——时段越少说明看房越拥挤。

挂牌的转化漏斗元数据，以 propertyId/listingId 为键：该挂牌支持哪些联系与看房动作（经纪人联系路径、看房资格及相关转化选项）。在搭建排期或咨询集成前先查它，保证你的流程只提供该挂牌真实支持的动作。

附着在房产上的辅助资源链接，以 propertyId 为键：网站随挂牌展示的上下文资源（指南、报告与相关页面）。用于把用户深链到官方上下文、审计挂牌完整度，或为归档数据集收集补充元数据。

房产的县公共记录事实与分区类别，以 propertyId/listingId 为键：评估员自己的记录（地块、结构与 zoning 指定），区别于经纪人撰写的挂牌。用它交叉验证挂牌宣称、做再开发筛查的分区尽调，并在数据错误进入评估前抓住它们。

挂牌的融资成本上下文，以 propertyId/listingId 为键：网站月供估算背后的房产税与相关输入。把真实的单套税数字嵌进可负担性计算器、租买对比与投资者还款模型，代替容易出错的县级均值。

某套挂牌的代理经纪人，以 propertyId/listingId 为键：这套房该联系谁。绘制挂牌与经纪人网络可看出哪些经纪人主导一个耕作区；也可把买家咨询路由到正确的挂牌方，或用当前持有目标市场库存的经纪人做外联名单种子。

服务某市场的房产经纪人目录。传入市场名（如 'New York Agents'，由地点补全中 searchType 为 Agents 的行给出），返回覆盖该市场的经纪人。准确的市场名改善结果，拿不准时先用地点补全解析。

经纪人姓名与市场的输入联想。传入自由文本（姓名片段、'New York Agents' 这类市场短语），返回匹配建议，用于解析成规范经纪人或市场标识。放在目录搜索框后面，也可在调经纪人资料前清洗 CRM 导入的拼写错误或不完整姓名。

单个经纪人的完整资料，以经纪人姓名（经纪人联想返回的规范名或 slug，如连字符形式）为键。返回经纪人的职业记录：业绩统计、在挂房源与市场覆盖。为排行榜页、转介尽调与招募研究生成。

单个经纪人的客户评价，以经纪人姓名（规范名或 slug）为键，可选 latestReviews 控制条数（默认 5）。把评价量与情感聚合成口碑分、驱动高分经纪人组件，并按主题挖掘一个市场经纪人的满意度。

把美国邮编解析为地点信息。传入 5 位邮编（如 10001），返回对应的城市与州上下文。用于在注册与搜索表单里自动填充城市州、在跑地点房源搜索前校验邮编，以及为批量覆盖任务建邮编与区域映射表。

枚举美国城市的全部邮编。传入城市名返回其邮编列表，覆盖任务由此把城市目标展开成逐邮编查询且无遗漏。适合领土规划、直邮定向与需要邮编粒度的城市级分析。

枚举美国县内的全部邮编。传入县名返回邮编列表——适合县级市场扫描、乡村与郊区收购研究、直邮定向，以及必须证明不漏任何邮编的州级管线。

轻量存活探针。无参数；健康服务返回 HTTP 200 与 {"status": true, "message": "server is running"}。把昂贵批量任务门控在本调用之后，并接入状态页，让管线在数据面退化时快速失败。