概览
想按城市或关键词搜索 Zillow 上的房源,拿到一批房源的列表数据——挂牌价格、地址、户型、面积、主图?给它一个搜索关键词(如 "Tampa, FL"),选择出租或在售类型,它会采集搜索结果中的房源列表信息,包括挂牌价格、地址、卧室数、浴室数、居住面积、主图链接、房源详情页链接等字段,可以直接导出到表格里做分析。
比起手工在 Zillow 上翻页浏览,它把一个搜索词的采集结果一次拉全并去重,适合做租房市场摸底、区域房源筛选和价格对比的数据底表。
数据说明
数据取自 Zillow 公开的搜索结果,按提交的关键词采集对应类型(出租/在售)的房源列表。同一条房源(以 Zillow 房源编号去重)只出现一次。挂牌价格和地址字段以 JSON 文本形式返回,内部包含金额、币种、城市、州、邮编等结构化子字段,使用时需自行解析。在售状态字段值如 FOR_RENT 表示出租中、FOR_SALE 表示在售中。采集时间和更新时间标记数据的抓取与清洗时刻,可作为数据新鲜度的参照。仅覆盖 Zillow 上公开可见的搜索结果。
结果长什么样
每条记录是一个 Zillow 房源:
| 房源编号 | 搜索关键词 | 在售状态 | 卧室数 | 浴室数 | 面积 | 挂牌价格 |
|---|---|---|---|---|---|---|
| 20493812 | Tampa, FL | FOR_RENT | 2 | 2 | 1200 | $2,850+/mo |
| 20615397 | Tampa, FL | FOR_SALE | 3 | 2 | 1850 | $425,000 |
另有房产类型、地块面积、主图、房源链接、搜索来源链接、图片数、上架天数、采集时间、更新时间等字段。
应用场景
- 做租房市场摸底时,按「搜索关键词」和「在售状态」分组,统计「挂牌价格」的分布,了解某城市出租房源的价格区间。
- 做区域房源筛选时,按「卧室数」和「面积」筛选符合条件的房源,结合「房源链接」逐个查看详情。
- 做价格对比时,将同一城市「在售」与「出租」结果交叉对比,分析售租比。
适用边界
单次提交一个搜索关键词;最多采集 100 条房源列表数据。仅覆盖 Zillow 公开可见的搜索结果。
- 适合用于
- 需要按城市或关键词搜索 Zillow 房源列表数据时
- 需要批量获取 Zillow 搜索结果中的房源基本信息(价格、地址、户型等)时
- 不要用于
- 需要单个房源的详细数据(估价、描述全文等)时——用 Zillow 房源详情采集
- 只查单个房源且要秒回——用同步查询类 App
失败处理
开发者声明的失败与重试处理方式,接入时建议一并写进系统提示词。
- 1任务失败属可重试错误,可原样重新提交
- 2部分房源采集失败时状态会显示 PARTIAL_SUCCEEDED,已成功的房源仍可拉取结果
- 3结果分页返回,条数多时请用完整导出而非反复翻页
输入参数
调用本 App 需要传入的参数,与 manifest.json 的 input.schema 同源。
- 搜索关键词
kw必填stringZillow 搜索关键词,通常为「城市, 州」格式,如 Tampa, FL。最多 512 个字符。示例Tampa, FL - 搜索类型
option选填string(enum)rent 搜索出租房源,buy 搜索在售房源,默认 rent可选值rentbuy默认值rent - 采集条数
crawl_num选填integer要从搜索结果中采集多少条房源,默认 1 条。值越大耗时和费用越高。范围1–100默认值1
输出数据
单条记录的字段结构,与 manifest.json 的 output.schema 同源。
- 房源编号
item_idstringZillow 房源唯一标识(zpid) - 搜索关键词
keywordstring提交时使用的搜索关键词 - 地址
listing_addressstring房源地址信息,包含城市、州、邮编等结构化子字段 - 挂牌价格
listing_pricestring房源价格信息,包含金额、币种、格式化文本等结构化子字段
调用方式
本 App 支持通过 MCP、API、SDK 与文件导出方式接入,各接入方式共享同一套能力与计价。所有请求统一使用 Authorization: Bearer 请求头完成身份认证,凭证为 API Key(长期有效,在开放平台创建);MCP 客户端另支持 OAuth 免密钥登录。CLI、Skill 等更多接入方式正在规划中。本 App 异步运行,支持中途取消:取消后任务停止;已写回的部分保留,按写回计费。
通过 MCP(Model Context Protocol)协议,可在 Claude、Cursor 等 AI 客户端中直接调用本 App。选择你的客户端与认证方式,复制下方配置即可接入。
客户端配置
把 Bearer 后替换为长期有效的 API Key 即可,各类客户端与 CI、无浏览器环境通用。
{
"mcpServers": {
"bazhuayu_datahub": {
"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 条计。
多个计费事件按各自口径独立累计,具体以每一项说明为准;任务失败不计费。
立即体验
填写参数直接运行,结果来自真实调用。