概览
想批量获取 Zillow 上房产的详情数据——估价、户型、面积、在售状态、描述全文?给它一组 Zillow 房源详情页链接,它会逐个采集并返回结构化的房源信息,包括 Zillow 估价(Zestimate 与 Rent Zestimate)、卧室数、居住面积、建造年份、每平方英尺单价等关键字段,可以直接导出到表格里做分析。
比起手工逐个打开 Zillow 页面抄数据,它把一批链接的采集结果一次拉全并去重,适合做房产估值参照、市场摸底和投资筛选的数据底表。
数据说明
数据取自 Zillow 公开的房源详情页,按提交的链接逐个采集,同一条房源(以 Zillow 房源编号去重)只出现一次。Zestimate 与 Rent Zestimate 是 Zillow 的专有估价,分别表示房产的市场估价和月租金估价,单位美元。地址、挂牌价格、地块面积等字段以文本形式返回,内部包含城市、州、邮编、金额、单位等结构化子字段,使用时需自行解析。采集时间标记数据抓取的时刻,可作为数据新鲜度的参照。只覆盖 Zillow 上公开可见的房源详情页,已删除或需要特殊权限的页面不在其中。
结果长什么样
每条记录是一个 Zillow 房源:
| 房源编号 | 在售状态 | 卧室数 | 面积 | Zestimate估值 | 采集时间 |
|---|---|---|---|---|---|
| 29984873 | sold | 4 | 1694 | 227400 | 2026-08-14T12:24:49 |
| 20615397 | for_sale | 3 | 1850 | 425000 | 2026-08-14T15:20:33 |
另有房源链接、房产类型、建造年份、每平方英尺单价、租金估价、地址、挂牌价格、地块面积、描述全文等字段。
应用场景
- 做房产估值时,把「Zestimate估值」与「挂牌价格」对比,判断标的市场价是高估还是低估。
- 做市场摸底时,按「房产类型」和「卧室数」分组统计「面积」和「每平方英尺单价」的分布,了解某区域房源的户型与价位格局。
- 做投资筛选时,用「租金估价」除以「Zestimate估值」算出租金回报率,按回报率排序筛出候选标的。
适用边界
单次最多提交 100 个房源链接;仅覆盖 Zillow 公开可见的房源详情页。
- 适合用于
- 需要批量获取 Zillow 房源的详情数据(估价、户型、面积等)时
- 需要一批房源的结构化数据做估值对比或市场分析时
- 不要用于
- 只查单个房源且要秒回——用同步查询类 App
- 需要 Zillow 搜索结果列表数据而非详情页数据时
失败处理
作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务失败属可重试错误,可原样重新提交
- 2部分房源采集失败时状态会显示 PARTIAL_SUCCEEDED,已成功的房源仍可拉取结果
- 3结果分页返回,条数多时请用完整导出而非反复翻页
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
| 字段名 | 业务名称 | 类型 | 必填 | 默认值 | 枚举 / 约束 | 示例 | 说明 |
|---|---|---|---|---|---|---|---|
| property_urls | 房源详情页链接列表 | array<object> | 是 | — | 最多 100 项 | [{"kw":"https://www.zillow.com/homedetails/240-Benedict-Rd-Bainbridge-NY-13733/29984873_zpid/"}] | 要采集的 Zillow 房源详情页 URL 列表,每条是一个完整的 Zillow 房源详情页链接,形如 https://www.zillow.com/homedetails/... |
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
| 字段名 | 业务名称 | 类型 | 示例 | 说明 |
|---|---|---|---|---|
| agent_info | 经纪人信息 | string | — | 房源经纪人的姓名、联系方式和执照等信息文本,原始记录未提供时为空 |
| at_a_glance_facts | 房源概览 | string | — | 房产类型、建造年份、停车和地块等概览信息文本,原始记录未提供时为空 |
| bathrooms_detail | 卫生间明细 | string | — | 完整卫生间、半卫生间等数量明细文本,原始记录未提供时为空 |
| bedroom_count | 卧室数 | integer | — | 卧室数量 |
| biz_id | 业务标识 | string | — | 房源在来源数据中的业务标识,原始记录未提供时为空 |
| broker_info | 经纪公司信息 | string | — | 房源买卖经纪人与经纪公司的信息文本,原始记录未提供时为空 |
| building_attributes | 建筑属性 | string | — | 房源建筑属性信息文本,原始记录未提供时为空 |
| clean_update_time | 更新时间 | string | — | 房源记录最近一次清洗更新时间,原始记录未提供时为空 |
| coordinates | 地理坐标 | string | — | 房源经纬度坐标信息文本,原始记录未提供时为空 |
| crawl_time | 采集时间 | string | — | 数据采集时间(ISO 8601 格式) |
| date_posted | 挂牌日期 | string | — | 房源首次或最近挂牌的日期时间,原始记录未提供时为空 |
| date_sold | 成交日期 | string | — | 房源成交日期时间,原始记录未提供时为空 |
| days_on_zillow | 在站天数 | integer | — | 房源在 Zillow 展示的累计天数,原始记录未提供时为空 |
| hoa_info | 业主协会信息 | string | — | 房源业主协会相关信息文本,原始记录未提供时为空 |
| home_type | 房产类型 | string | — | 房产类型,如 SINGLE_FAMILY(独栋)等 |
| item_id | 房源编号 | string | — | Zillow 房源唯一标识(zpid) |
| keyword | 检索值 | string | — | 本条房源关联的检索值,原始记录未提供时为空 |
| last_sold_price | 最近成交价 | integer | — | 房源最近一次成交价格,单位美元,原始记录未提供时为空 |
| listing_address | 地址 | string | — | 房源地址信息,包含城市、州、邮编等结构化子字段 |
| listing_mortgage_rates | 按揭利率 | string | — | 房源相关按揭利率信息文本,原始记录未提供时为空 |
| listing_photos | 房源图片 | string | — | 房源图片链接及说明信息文本,原始记录未提供时为空 |
| listing_price | 挂牌价格 | string | — | 房源价格信息,包含金额、币种、格式化文本等结构化子字段 |
| listing_price_history | 价格历史 | string | — | 房源挂牌、调价和成交等价格历史信息文本,原始记录未提供时为空 |
| listing_provider | 挂牌提供方 | string | — | 房源挂牌信息提供方文本,原始记录未提供时为空 |
| listing_status | 在售状态 | string | — | 房源挂牌状态,如 sold、for_sale 等 |
| listing_tax_history | 税费历史 | string | — | 房源历年税费和估值历史信息文本,原始记录未提供时为空 |
| listing_type | 挂牌类型 | string | — | 房源挂牌类型及拍卖、止赎、新房等标记信息文本,原始记录未提供时为空 |
| living_area | 面积 | integer | — | 居住面积,单位平方英尺 |
| lot_area | 地块面积 | string | — | 地块面积信息,包含数值、单位、格式化文本等结构化子字段 |
| main_image | 主图 | string | — | 房源主图不同尺寸的链接信息文本,原始记录未提供时为空 |
| mls_info | MLS 信息 | string | — | 房源多重上市服务的编号、名称和更新时间等信息文本,原始记录未提供时为空 |
| monthly_hoa_fee | 每月业主协会费 | string | — | 房源每月业主协会费用,原始记录未提供时为空 |
| nearby_properties | 附近房源 | string | — | 附近房源的地址、价格和房型等信息文本,原始记录未提供时为空 |
| nearby_schools | 附近学校 | string | — | 附近学校的名称、评级、年级和距离等信息文本,原始记录未提供时为空 |
| on_market_date | 上市日期 | string | — | 房源进入市场的日期时间,原始记录未提供时为空 |
| parcel_id | 地块编号 | string | — | 房源对应的地块编号,原始记录未提供时为空 |
| parking_info | 停车信息 | string | — | 车库、车位数量和停车设施等信息文本,原始记录未提供时为空 |
| photo_count | 图片数量 | integer | — | 房源公开图片数量,原始记录未提供时为空 |
| price_change | 价格变动额 | integer | — | 房源最近一次价格变动金额,单位美元,原始记录未提供时为空 |
| price_changed_at | 价格变动时间 | string | — | 房源最近一次价格变动的日期时间,原始记录未提供时为空 |
| price_per_sqft | 每平方英尺单价 | integer | — | 每平方英尺单价,单位美元 |
| property_description | 描述全文 | string | — | 房源描述全文 |
| property_features | 房产设施 | string | — | 房源装修、设施、供暖、制冷和建筑特征等信息文本,原始记录未提供时为空 |
| property_tax_rate | 房产税率 | number | — | 房源所在地区的房产税率,原始记录未提供时为空 |
| property_url | 房源链接 | string | — | Zillow 房源详情页 URL |
| rent_zestimate | 租金估价 | integer | — | Zillow 月租金估价,单位美元 |
| school_districts | 学区信息 | string | — | 房源所属小学、初中和高中学区信息文本,原始记录未提供时为空 |
| virtual_tour_url | 虚拟看房链接 | string | — | 房源虚拟看房页面链接,原始记录未提供时为空 |
| year_built | 建造年份 | integer | — | 房产建造年份 |
| zestimate | Zestimate估值 | integer | — | Zillow 房产市场估价,单位美元 |
| submitted_property_url | 提交房源链接 | string | — | 本次任务提交时填写的 Zillow 房源链接 |
| no_data | 无数据 | boolean | — | 本次提交的房源链接是否未采集到有效房源详情 |
记录 Schema
输出按记录逐条返回。记录主键为 item_id,去重、增量、关联以它为准。
{
"type": "object",
"properties": {
"agent_info": {
"type": "string",
"title": "经纪人信息",
"description": "房源经纪人的姓名、联系方式和执照等信息文本,原始记录未提供时为空"
},
"at_a_glance_facts": {
"type": "string",
"title": "房源概览",
"description": "房产类型、建造年份、停车和地块等概览信息文本,原始记录未提供时为空"
},
"bathrooms_detail": {
"type": "string",
"title": "卫生间明细",
"description": "完整卫生间、半卫生间等数量明细文本,原始记录未提供时为空"
},
"bedroom_count": {
"type": "integer",
"title": "卧室数",
"description": "卧室数量"
},
"biz_id": {
"type": "string",
"title": "业务标识",
"description": "房源在来源数据中的业务标识,原始记录未提供时为空"
},
"broker_info": {
"type": "string",
"title": "经纪公司信息",
"description": "房源买卖经纪人与经纪公司的信息文本,原始记录未提供时为空"
},
"building_attributes": {
"type": "string",
"title": "建筑属性",
"description": "房源建筑属性信息文本,原始记录未提供时为空"
},
"clean_update_time": {
"type": "string",
"title": "更新时间",
"description": "房源记录最近一次清洗更新时间,原始记录未提供时为空"
},
"coordinates": {
"type": "string",
"title": "地理坐标",
"description": "房源经纬度坐标信息文本,原始记录未提供时为空"
},
"crawl_time": {
"type": "string",
"title": "采集时间",
"description": "数据采集时间(ISO 8601 格式)"
},
"date_posted": {
"type": "string",
"title": "挂牌日期",
"description": "房源首次或最近挂牌的日期时间,原始记录未提供时为空"
},
"date_sold": {
"type": "string",
"title": "成交日期",
"description": "房源成交日期时间,原始记录未提供时为空"
},
"days_on_zillow": {
"type": "integer",
"title": "在站天数",
"description": "房源在 Zillow 展示的累计天数,原始记录未提供时为空"
},
"hoa_info": {
"type": "string",
"title": "业主协会信息",
"description": "房源业主协会相关信息文本,原始记录未提供时为空"
},
"home_type": {
"type": "string",
"title": "房产类型",
"description": "房产类型,如 SINGLE_FAMILY(独栋)等"
},
"item_id": {
"type": "string",
"title": "房源编号",
"description": "Zillow 房源唯一标识(zpid)"
},
"keyword": {
"type": "string",
"title": "检索值",
"description": "本条房源关联的检索值,原始记录未提供时为空"
},
"last_sold_price": {
"type": "integer",
"title": "最近成交价",
"description": "房源最近一次成交价格,单位美元,原始记录未提供时为空"
},
"listing_address": {
"type": "string",
"title": "地址",
"description": "房源地址信息,包含城市、州、邮编等结构化子字段"
},
"listing_mortgage_rates": {
"type": "string",
"title": "按揭利率",
"description": "房源相关按揭利率信息文本,原始记录未提供时为空"
},
"listing_photos": {
"type": "string",
"title": "房源图片",
"description": "房源图片链接及说明信息文本,原始记录未提供时为空"
},
"listing_price": {
"type": "string",
"title": "挂牌价格",
"description": "房源价格信息,包含金额、币种、格式化文本等结构化子字段"
},
"listing_price_history": {
"type": "string",
"title": "价格历史",
"description": "房源挂牌、调价和成交等价格历史信息文本,原始记录未提供时为空"
},
"listing_provider": {
"type": "string",
"title": "挂牌提供方",
"description": "房源挂牌信息提供方文本,原始记录未提供时为空"
},
"listing_status": {
"type": "string",
"title": "在售状态",
"description": "房源挂牌状态,如 sold、for_sale 等"
},
"listing_tax_history": {
"type": "string",
"title": "税费历史",
"description": "房源历年税费和估值历史信息文本,原始记录未提供时为空"
},
"listing_type": {
"type": "string",
"title": "挂牌类型",
"description": "房源挂牌类型及拍卖、止赎、新房等标记信息文本,原始记录未提供时为空"
},
"living_area": {
"type": "integer",
"title": "面积",
"description": "居住面积,单位平方英尺"
},
"lot_area": {
"type": "string",
"title": "地块面积",
"description": "地块面积信息,包含数值、单位、格式化文本等结构化子字段"
},
"main_image": {
"type": "string",
"title": "主图",
"description": "房源主图不同尺寸的链接信息文本,原始记录未提供时为空"
},
"mls_info": {
"type": "string",
"title": "MLS 信息",
"description": "房源多重上市服务的编号、名称和更新时间等信息文本,原始记录未提供时为空"
},
"monthly_hoa_fee": {
"type": "string",
"title": "每月业主协会费",
"description": "房源每月业主协会费用,原始记录未提供时为空"
},
"nearby_properties": {
"type": "string",
"title": "附近房源",
"description": "附近房源的地址、价格和房型等信息文本,原始记录未提供时为空"
},
"nearby_schools": {
"type": "string",
"title": "附近学校",
"description": "附近学校的名称、评级、年级和距离等信息文本,原始记录未提供时为空"
},
"on_market_date": {
"type": "string",
"title": "上市日期",
"description": "房源进入市场的日期时间,原始记录未提供时为空"
},
"parcel_id": {
"type": "string",
"title": "地块编号",
"description": "房源对应的地块编号,原始记录未提供时为空"
},
"parking_info": {
"type": "string",
"title": "停车信息",
"description": "车库、车位数量和停车设施等信息文本,原始记录未提供时为空"
},
"photo_count": {
"type": "integer",
"title": "图片数量",
"description": "房源公开图片数量,原始记录未提供时为空"
},
"price_change": {
"type": "integer",
"title": "价格变动额",
"description": "房源最近一次价格变动金额,单位美元,原始记录未提供时为空"
},
"price_changed_at": {
"type": "string",
"title": "价格变动时间",
"description": "房源最近一次价格变动的日期时间,原始记录未提供时为空"
},
"price_per_sqft": {
"type": "integer",
"title": "每平方英尺单价",
"description": "每平方英尺单价,单位美元"
},
"property_description": {
"type": "string",
"title": "描述全文",
"description": "房源描述全文"
},
"property_features": {
"type": "string",
"title": "房产设施",
"description": "房源装修、设施、供暖、制冷和建筑特征等信息文本,原始记录未提供时为空"
},
"property_tax_rate": {
"type": "number",
"title": "房产税率",
"description": "房源所在地区的房产税率,原始记录未提供时为空"
},
"property_url": {
"type": "string",
"title": "房源链接",
"description": "Zillow 房源详情页 URL"
},
"rent_zestimate": {
"type": "integer",
"title": "租金估价",
"description": "Zillow 月租金估价,单位美元"
},
"school_districts": {
"type": "string",
"title": "学区信息",
"description": "房源所属小学、初中和高中学区信息文本,原始记录未提供时为空"
},
"virtual_tour_url": {
"type": "string",
"title": "虚拟看房链接",
"description": "房源虚拟看房页面链接,原始记录未提供时为空"
},
"year_built": {
"type": "integer",
"title": "建造年份",
"description": "房产建造年份"
},
"zestimate": {
"type": "integer",
"title": "Zestimate估值",
"description": "Zillow 房产市场估价,单位美元"
},
"submitted_property_url": {
"type": "string",
"title": "提交房源链接",
"description": "本次任务提交时填写的 Zillow 房源链接"
},
"no_data": {
"type": "boolean",
"title": "无数据",
"description": "本次提交的房源链接是否未采集到有效房源详情"
}
},
"required": [],
"additionalProperties": false
}调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"dataing11__zillow-property-detail": {
"type": "http",
"url": "https://mcp-v2.bazhuayu.com?pin=dataing11/zillow-property-detail",
"headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
}
}
}让 AI 自己完成配置
不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。
如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。
价格
按实际成功返回的数据条数计费,任务失败不计费。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。