Zillow 美国与加拿大房产数据 APIs

用自由文本地点（城市、县、社区或邮编）搜索美国与加拿大的实时房源，筛选条件与门户站点对齐。已用 Los Angeles, CA 实测，首页返回 41 条真实房源。响应信封带 status（OK/ERROR）、request_id、参数回显与 data 房源卡片数组；每张卡片含 zpid、完整地址字段（address、streetAddress、city、state、zipcode）、价格与币种、zestimate 与 rentZestimate、卧室、浴室、居住面积、地块面积（lotAreaValue/lotAreaUnit）、daysOnZillow 挂牌天数、经纬度、homeType、statusType/statusText、imgSrc 照片与 detailUrl 详情链接。用 home_status 在 FOR_SALE、FOR_RENT、RECENTLY_SOLD 三种库存间切换，用 sort（NEWEST、PRICE_LOW_HIGH 等）排序。每页最多 41 条，可翻第 1-100 页。筛选有效但无匹配时返回 HTTP 200 与空 data 数组；地点无法识别时返回精确的 Invalid location 错误。价格区间请保持合理——离谱的数值（如万亿级最低价）可能触发临时 503 而非空结果。

以任意经纬度为中心做半径搜索：传 lat、long 与直径 diameter（英里，0.1-100，默认 1.0）。已在圣莫尼卡（34.01822, -118.504744）实测，返回该点附近的真实公寓房源。响应与地点搜索共用同一套信封与房源卡片结构：status、参数回显与 data 数组，每行含 zpid、地址、价格、zestimate、卧室、浴室、居住面积、经纬度、homeType、imgSrc 与 detailUrl。地点搜索的全部筛选（home_status、sort、价格、卧室、浴室、面积、地块、HOA、房型）在这里同样生效，每页最多 41 条。

画圈找房：polygon 传逗号分隔的坐标对，每对先经度后纬度、中间空格（lng1 lat1,lng2 lat2,...）。首尾坐标不同时边界自动闭合，学区边界、社区轮廓、洪泛区等不规则形状都能直接用。结果沿用同样的信封与房源卡片结构：status、参数回显与 data 数组，每行含 zpid、地址、价格、zestimate、卧室、浴室、居住面积、经纬度、照片与 detailUrl。全部标准筛选（home_status、sort、价格、卧室、浴室、面积、地块、HOA、房型）与翻页均可用。已预填一个可直接运行的示例多边形，先跑通格式再画自己的区域。

把房产 ID（zpid）——或完整房源链接——解析成一份完整的房产档案。zpid 取自任意搜索结果卡片或 detailUrl 末尾。已实测：用搜索命中的 zpid 查详情，返回的地址与价格和搜索卡片一致，并带有深层 resoFacts 区块。data 对象含 price、streetAddress、city、state、zipcode 及 resoFacts：卧室、浴室（全卫/半卫拆分）、家电、协会信息（HOA 名称、费用与电话）、associationFee、atAGlanceFacts、无障碍设施、停车、建成年份等字段。字段填充因房而异——请保留空值而不是编造数据。这是搜索之后的增强步骤：先搜索候选，再对用户真正打开的房子取详情。

把普通街道地址解析成与按 ID 查询相同的完整房产档案——不需要 zpid。已用 1443 Bellevue Ave Los Angeles, CA 90026 实测，返回匹配的住宅（4 卧 3 卫，1910 年建成）及其当前价格。data 对象带 price、streetAddress、city、state、zipcode 与 resoFacts 区块（卧室、浴室拆分、家电、协会、停车等），字段填充同样因房而异。当你的输入来自表单、邮寄名单或表格里的地址而非搜索得到的 ID 时，用这个接口最合适。

按 zpid 或房源链接返回房产的当前市场估值（Zestimate）。已实测：用搜索得到的 zpid 查估值，结果与该房产搜索卡片上的 zestimate 字段完全一致，搜索快照与单点查询保持一致。响应刻意保持极简——data 里只有估值数值——使其成为按周期刷新投资组合估值最省的方式。zpid 取自搜索结果卡片或 detailUrl 末尾。需要租金估值时，直接用搜索卡片上已有的 rentZestimate 字段即可。

用城市-州 slug（如 new-york-ny、los-angeles-ca）搜索美国任意城市的经纪人目录，可加姓名筛选。已对纽约实测：报告 70,685 名经纪人，首页返回真实档案。data 对象带 total_agents 与 agents 数组（每页最多 15 人），每个经纪人含 cardTitle（展示名）、encodedZuid（稳定经纪人标识）、imageUrl、isTopAgent、tags（如 TEAM）、profileData 统计（带标签的格式化成交数量与价格区间）与 reviewInformation（reviewAverage 与 reviewCount）。用 page 遍历目录。encodedZuid 是其他经纪人相关功能使用的标识，请随经纪人记录一并保存。