用途:通过 Redfin 非官方 API(https://www.redfin.com/stingray/)获取房源搜索、挂牌数据、AVM 估值与房产历史,用于编写房产数据抓取或分析代码。
主要能力:全部请求为 HTTP GET,需带 User-Agent(当前 Chrome UA),可选认证 Cookie(RF_ACCESS_LEVEL、RF_AUTH、RF_W_AUTH、RF_SECURE_AUTH、RF_PARTY_ID)。响应统一为 {version, errorMessage, resultCode, payload} 包装,resultCode==0 且 errorMessage=="Success" 表示成功,payload 结构随端点不同。
使用方式:搜索流程先调用 /stingray/do/location-autocomplete?location={query}&v=2 获取 region ID(格式 {region_type}_{region_id},按 _ 拆分),再用 /stingray/api/gis-csv?region_id=®ion_type= 下载 CSV(无 {}& 前缀,第 0 行表头、第 1 行 MLS 免责声明、第 2 行起为数据);从 URL 列调用 /stingray/api/home/details/initialInfo?path= 获取 propertyId、listingId 和经纬度。详情端点多在 /stingray/api/home/details/ 下,部分仅需 propertyId(可加 accessLevel=1、pageType=3),部分需 propertyId 与 listingId,另有按 listingId、tableId 的端点。GISCSV 默认参数给出广泛结果,单户家庭可设 uipt=1、sf=1,2,5,6,7。
解析与限制:除 GISCSV 外所有响应前缀 {}& (恰好 4 字节),解析前需剥离;数据嵌套深,可用 JMESPath 提取。事件日期为 Unix 毫秒时间戳;photoAttribution 形如 "Listed by Jane Smith • Acme Realty.",按 • 拆分并去除前缀与句点。需在请求间加延迟(通常几秒)以免被封锁;需同时检查 HTTP 状态码与 resultCode/errorMessage;轮询时可用 MD5 哈希载荷去重。该 API 为非官方,稳定性与可用性未获保证,具体价格、收费、采集频率上限等资料未提供。