logo

Zillow 房源搜索采集

提交城市或关键词搜索 Zillow,批量采集搜索结果中的房源列表数据

概览

想按城市或关键词搜索 Zillow 上的房源,拿到一批房源的列表数据——挂牌价格、地址、户型、面积、主图?给它一个搜索关键词(如 "Tampa, FL"),选择出租或在售类型,它会采集搜索结果中的房源列表信息,包括挂牌价格、地址、卧室数、浴室数、居住面积、主图链接、房源详情页链接等字段,可以直接导出到表格里做分析。

比起手工在 Zillow 上翻页浏览,它把一个搜索词的采集结果一次拉全并去重,适合做租房市场摸底、区域房源筛选和价格对比的数据底表。

数据说明

数据取自 Zillow 公开的搜索结果,按提交的关键词采集对应类型(出租/在售)的房源列表。同一条房源(以 Zillow 房源编号去重)只出现一次。挂牌价格和地址字段以 JSON 文本形式返回,内部包含金额、币种、城市、州、邮编等结构化子字段,使用时需自行解析。在售状态字段值如 FOR_RENT 表示出租中、FOR_SALE 表示在售中。采集时间和更新时间标记数据的抓取与清洗时刻,可作为数据新鲜度的参照。仅覆盖 Zillow 上公开可见的搜索结果。

结果长什么样

每条记录是一个 Zillow 房源:

房源编号搜索关键词在售状态卧室数浴室数面积挂牌价格
20493812Tampa, FLFOR_RENT221200$2,850+/mo
20615397Tampa, FLFOR_SALE321850$425,000

另有房产类型、地块面积、主图、房源链接、搜索来源链接、图片数、上架天数、采集时间、更新时间等字段。

应用场景

  • 做租房市场摸底时,按「搜索关键词」和「在售状态」分组,统计「挂牌价格」的分布,了解某城市出租房源的价格区间。
  • 做区域房源筛选时,按「卧室数」和「面积」筛选符合条件的房源,结合「房源链接」逐个查看详情。
  • 做价格对比时,将同一城市「在售」与「出租」结果交叉对比,分析售租比。

适用边界

单次提交一个搜索关键词;最多采集 100 条房源列表数据。仅覆盖 Zillow 公开可见的搜索结果。

  • 适合用于
  • 需要按城市或关键词搜索 Zillow 房源列表数据时
  • 需要批量获取 Zillow 搜索结果中的房源基本信息(价格、地址、户型等)时
  • 不要用于
  • 需要单个房源的详细数据(估价、描述全文等)时——用 Zillow 房源详情采集
  • 只查单个房源且要秒回——用同步查询类 App

失败处理

作者声明的失败与重试处理方式,接入时建议一并写进系统提示词。

  1. 1任务失败属可重试错误,可原样重新提交
  2. 2部分房源采集失败时状态会显示 PARTIAL_SUCCEEDED,已成功的房源仍可拉取结果
  3. 3结果分页返回,条数多时请用完整导出而非反复翻页

输入参数

调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。

字段名业务名称类型必填默认值枚举 / 约束示例说明
kw搜索关键词stringTampa, FLZillow 搜索关键词,通常为「城市, 州」格式,如 Tampa, FL。最多 512 个字符。
option搜索类型string(enum)rentrent / buyrent 搜索出租房源,buy 搜索在售房源,默认 rent
crawl_num采集条数integer11–100要从搜索结果中采集多少条房源,默认 1 条。值越大耗时和费用越高。

输出数据

单条记录的字段结构,与 manifest.json 的 output.schema 同源。

字段名业务名称类型示例说明
item_id房源编号stringZillow 房源唯一标识(zpid)
keyword搜索关键词string提交时使用的搜索关键词
listing_address地址string房源地址信息,包含城市、州、邮编等结构化子字段
listing_price挂牌价格string房源价格信息,包含金额、币种、格式化文本等结构化子字段
listing_status在售状态string房源挂牌状态,如 FOR_RENT(出租中)、FOR_SALE(在售中)等
home_type房产类型string房产类型,如 SINGLE_FAMILY(独栋)等
bedroom_count卧室数integer卧室数量
bathroom_count浴室数integer浴室数量
living_area面积integer居住面积,单位平方英尺
lot_area地块面积string地块面积信息
main_image_url主图string房源主图 URL
property_url房源链接stringZillow 房源详情页 URL
source_search_url搜索来源stringZillow 搜索结果页 URL
photo_count图片数integer房源图片数量
days_on_zillow上架天数integer在 Zillow 上的上架天数
crawl_time采集时间string数据采集时间(ISO 8601 格式)
clean_update_time更新时间string数据清洗更新时间(ISO 8601 格式)
biz_id业务标识string房源记录关联的业务检索标识,原始记录未提供时为空
broker_info经纪信息string房源经纪公司或经纪人相关信息文本,原始记录未提供时为空
coordinates地理坐标string房源经纬度坐标信息文本,原始记录未提供时为空
has_3d_model_flag是否有 3D 模型boolean房源是否提供 3D 模型,原始记录未提供时为空
has_image_flag是否有图片boolean房源是否提供图片,原始记录未提供时为空
has_video_flag是否有视频boolean房源是否提供视频,原始记录未提供时为空
listing_photos房源图片string房源图片链接及说明信息文本,原始记录未提供时为空
listing_type挂牌类型string房源挂牌类型信息文本,原始记录未提供时为空
marketing_tagline营销标语string房源公开展示的营销标语,原始记录未提供时为空
price_change价格变动额integer房源最近一次价格变动金额,原始记录未提供时为空
price_changed_at价格变动时间string房源最近一次价格变动的日期时间,原始记录未提供时为空
price_reduction降价信息string房源降价信息文本,原始记录未提供时为空
rent_zestimate租金估价integerZillow 月租金估价,原始记录未提供时为空
tax_assessed_value税务评估价值integer房源税务评估价值,原始记录未提供时为空
zestimateZestimate估值integerZillow 房产市场估价,原始记录未提供时为空
zillow_owned_flag是否 Zillow 持有boolean房源是否由 Zillow 持有,原始记录未提供时为空
submitted_keyword提交关键词string本次任务提交时填写的搜索关键词
no_data无数据boolean本次提交的搜索关键词是否未采集到有效房源结果

记录 Schema

输出按记录逐条返回。记录主键为 item_id,去重、增量、关联以它为准。

output.schema
{
  "type": "object",
  "properties": {
    "item_id": {
      "type": "string",
      "title": "房源编号",
      "description": "Zillow 房源唯一标识(zpid)"
    },
    "keyword": {
      "type": "string",
      "title": "搜索关键词",
      "description": "提交时使用的搜索关键词"
    },
    "listing_address": {
      "type": "string",
      "title": "地址",
      "description": "房源地址信息,包含城市、州、邮编等结构化子字段"
    },
    "listing_price": {
      "type": "string",
      "title": "挂牌价格",
      "description": "房源价格信息,包含金额、币种、格式化文本等结构化子字段"
    },
    "listing_status": {
      "type": "string",
      "title": "在售状态",
      "description": "房源挂牌状态,如 FOR_RENT(出租中)、FOR_SALE(在售中)等"
    },
    "home_type": {
      "type": "string",
      "title": "房产类型",
      "description": "房产类型,如 SINGLE_FAMILY(独栋)等"
    },
    "bedroom_count": {
      "type": "integer",
      "title": "卧室数",
      "description": "卧室数量"
    },
    "bathroom_count": {
      "type": "integer",
      "title": "浴室数",
      "description": "浴室数量"
    },
    "living_area": {
      "type": "integer",
      "title": "面积",
      "description": "居住面积,单位平方英尺"
    },
    "lot_area": {
      "type": "string",
      "title": "地块面积",
      "description": "地块面积信息"
    },
    "main_image_url": {
      "type": "string",
      "title": "主图",
      "description": "房源主图 URL"
    },
    "property_url": {
      "type": "string",
      "title": "房源链接",
      "description": "Zillow 房源详情页 URL"
    },
    "source_search_url": {
      "type": "string",
      "title": "搜索来源",
      "description": "Zillow 搜索结果页 URL"
    },
    "photo_count": {
      "type": "integer",
      "title": "图片数",
      "description": "房源图片数量"
    },
    "days_on_zillow": {
      "type": "integer",
      "title": "上架天数",
      "description": "在 Zillow 上的上架天数"
    },
    "crawl_time": {
      "type": "string",
      "title": "采集时间",
      "description": "数据采集时间(ISO 8601 格式)"
    },
    "clean_update_time": {
      "type": "string",
      "title": "更新时间",
      "description": "数据清洗更新时间(ISO 8601 格式)"
    },
    "biz_id": {
      "type": "string",
      "title": "业务标识",
      "description": "房源记录关联的业务检索标识,原始记录未提供时为空"
    },
    "broker_info": {
      "type": "string",
      "title": "经纪信息",
      "description": "房源经纪公司或经纪人相关信息文本,原始记录未提供时为空"
    },
    "coordinates": {
      "type": "string",
      "title": "地理坐标",
      "description": "房源经纬度坐标信息文本,原始记录未提供时为空"
    },
    "has_3d_model_flag": {
      "type": "boolean",
      "title": "是否有 3D 模型",
      "description": "房源是否提供 3D 模型,原始记录未提供时为空"
    },
    "has_image_flag": {
      "type": "boolean",
      "title": "是否有图片",
      "description": "房源是否提供图片,原始记录未提供时为空"
    },
    "has_video_flag": {
      "type": "boolean",
      "title": "是否有视频",
      "description": "房源是否提供视频,原始记录未提供时为空"
    },
    "listing_photos": {
      "type": "string",
      "title": "房源图片",
      "description": "房源图片链接及说明信息文本,原始记录未提供时为空"
    },
    "listing_type": {
      "type": "string",
      "title": "挂牌类型",
      "description": "房源挂牌类型信息文本,原始记录未提供时为空"
    },
    "marketing_tagline": {
      "type": "string",
      "title": "营销标语",
      "description": "房源公开展示的营销标语,原始记录未提供时为空"
    },
    "price_change": {
      "type": "integer",
      "title": "价格变动额",
      "description": "房源最近一次价格变动金额,原始记录未提供时为空"
    },
    "price_changed_at": {
      "type": "string",
      "title": "价格变动时间",
      "description": "房源最近一次价格变动的日期时间,原始记录未提供时为空"
    },
    "price_reduction": {
      "type": "string",
      "title": "降价信息",
      "description": "房源降价信息文本,原始记录未提供时为空"
    },
    "rent_zestimate": {
      "type": "integer",
      "title": "租金估价",
      "description": "Zillow 月租金估价,原始记录未提供时为空"
    },
    "tax_assessed_value": {
      "type": "integer",
      "title": "税务评估价值",
      "description": "房源税务评估价值,原始记录未提供时为空"
    },
    "zestimate": {
      "type": "integer",
      "title": "Zestimate估值",
      "description": "Zillow 房产市场估价,原始记录未提供时为空"
    },
    "zillow_owned_flag": {
      "type": "boolean",
      "title": "是否 Zillow 持有",
      "description": "房源是否由 Zillow 持有,原始记录未提供时为空"
    },
    "submitted_keyword": {
      "type": "string",
      "title": "提交关键词",
      "description": "本次任务提交时填写的搜索关键词"
    },
    "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 配置
{
  "mcpServers": {
    "dataing11__zillow-property-search": {
      "type": "http",
      "url": "https://mcp-v2.bazhuayu.com?pin=dataing11/zillow-property-search",
      "headers": { "Authorization": "Bearer <YOUR_API_KEY>" }
    }
  }
}

让 AI 自己完成配置

不想手动改配置?复制安装提示词,粘贴到任意 AI 客户端对话框,由它按自身方式完成接入(提示词会让 AI 向你索要 API Key,避免凭证留在对话记录或共享配置里)。

如需在同一个 MCP 连接里指定多个 App,前往 MCP 连接页(已为你指定本 App)。

价格

返回一条房源

按实际成功返回的数据条数计费,任务失败不计费。每 41 条为一个计费单位,不足 41 条按 41 条计。

¥0.015/ 41 条

多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。

立即体验

填写参数直接运行,结果来自真实调用。

示例
参数按 input.schema 校验后提交
请先填写必填参数
¥0.015 / 41 条