使用场景

按邮政编码,从 Zillow 房源追踪房价和租金

按邮政编码以 JSON 获取 Zillow 在售、出租或近期成交的房源,含价格、卧室、卫浴、面积、地址和 Zestimate,用来追踪本地市场。

预付费,无订阅REST 或 MCP一个密钥搞定模型、数据和智能体
Zillowlovelyjsonitems[0]"address": "412 Oak Ln, Austin, T…"price": 689000"beds": 3"baths": 2"living_area": 1840"zestimate": 672000

如果你投资出租房、作为经纪人给房子定价,或者要做市场报告,就需要知道某个邮政编码区域内的房子挂牌多少钱、成交多少钱、租金多少,而且是本月的数据,不是季度 PDF 里的旧数字。Zillow 能显示这些,但一次只能搜一个。Lovely Router 替你执行搜索:传入邮政编码,每套房源返回一个 JSON 对象,按房源数量从预付费余额中计费。用一个 API 密钥,就能从脚本、表格任务或 AI 智能体中运行。

交给你的 AI 智能体

把这段提示词复制到 Claude Code、Cursor、Codex 或任何编程智能体中。它会告诉智能体文档在哪里,以及如何使用你的 API 密钥。

按邮政编码,从 Zillow 房源追踪房价和租金. Use the Lovely Router data tools: each returns JSON and is billed per result.

- Docs (read first): https://lovelyrouter.com/docs/tools/find.md and https://lovelyrouter.com/docs/tools/run.md
- Plan first: POST https://lovelyrouter.com/v1/tools/suggest with `{"task": "<my task in plain words>"}` (free). It returns the tools to run in order, each with an example `input`, the `input_required` fields, an estimated cost and a ready-made `run` request. Replace the example values with my task's; if a field is unclear, read the tool with GET https://lovelyrouter.com/v1/tools/<id>. To browse instead, POST https://lovelyrouter.com/v1/tools/discover searches the catalog.
- Show me the plan and its estimated cost (`total_est_cost_usd`) before running anything large.
- Run: POST https://lovelyrouter.com/v1/tools/<id>/run with `{"input": {...}, "max_results": N}`. A 200 has the finished run with `items`; a 202 means it is still running, so poll the `poll` path until `status` is `succeeded`, `failed`, `timed_out` or `stopped`.
- Only delivered results are billed. Keep max_results small on the first run, check the output, then scale up.
- If you support MCP, connect https://lovelyrouter.com/mcp instead (Streamable HTTP, same key; https://lovelyrouter.com/docs/tools/mcp.md) and use suggest_tools, get_tool and run_tool.
- Auth: read my API key from the LOVELY_API_KEY environment variable and send it as `Authorization: Bearer $LOVELY_API_KEY`. Never print or commit the key. If it is not set, ask me to create one at https://lovelyrouter.com/app/keys.
- Billing is prepaid: every call is charged to my balance, so test with a small request before running anything large.
- Every docs page is plain Markdown; the full index is https://lovelyrouter.com/llms.txt.

My task: <the inputs (links, keywords or accounts) and how many results you need>
01

工作原理

010203
  1. 列出你的邮政编码

    选出你关注的街区的邮政编码:你持有房产的地方、你想买房的地方、你的客户居住的地方。

  2. 设置上限后运行工具

    发送到 POST /v1/tools/zillow-listings/run,把 operation 设为 buy、rent 或 sold,用 maxItems 指定房源数量,并用 max_results 作为运行上限。运行会从你的余额中预留它的最高费用,并以 JSON 返回房源。

  3. 计算并对比

    对每个邮政编码,计算价格中位数、每平方英尺居住面积的价格,以及与 Zestimate 的差距。带上日期保存,逐月对比。

02

一次请求获取邮政编码下的房源

搜索 Zillow 房源在 locations 中接受邮政编码。可用 minPrice 和 maxPrice 缩小范围(0 表示不限;租金按字段标注的口径是每周价格)。对于在售房源,agentListed 和 ownerPosted 决定返回哪类挂牌:

curl https://lovelyrouter.com/v1/tools/zillow-listings/run \
  -H "Authorization: Bearer $LOVELY_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "input": {
      "locations": ["78701"],
      "operation": "buy",
      "maxItems": 5
    },
    "max_results": 5
  }'

运行超过 60 秒仍未结束时会返回 202;轮询方法见运行工具。一次运行最多可返回 200 套房源。

03

每套房源包含什么

Field groupWhat you get
价格挂牌价或成交价
规模卧室、卫浴和居住面积
位置地址
估值Zillow 的 Zestimate
04

使用方案

每月市场快照。

每月 1 日,对你追踪的每个邮政编码运行 buy,存储挂牌价中位数和房源数量,并画成图表。

租售比筛选。

对同一个邮政编码分别运行 rent 和 buy,比较典型租金与每间卧室的典型价格,找出适合出租的区域。

用成交案例给房子定价。

对该邮政编码运行 sold,保留卧室、卫浴和居住面积相近的房子,把它们的价格作为参照。

找出定价过高的房源。

对 buy 的结果,计算挂牌价与 Zestimate 的比值,列出远高于它的房源。

在预算内淘好房。

设置 minPrice 和 maxPrice,每天早上把新房源发给自己。

更想用自然语言?连接 MCP 服务器,然后告诉 Claude Code 或 Cursor:"对邮政编码 78701、78702 和 78704,各获取 40 套在售房源,展示价格中位数、居住面积中位数,以及与 Zestimate 差距的中位数。把 max_results 设为 120。"

06

费用说明

按房源计费:开始运行时会预留最高费用,即单次调用费加上单套房源费乘以 max_results,运行结束后按实际返回的数量结算,其余预留金额退回你的余额。失败或超时的运行只为已交付的房源付费,开始时就被拒绝的运行不收费。

追踪 12 个邮政编码、每个 50 套房源,按 600 套房源计费。没有订阅,也没有每月最低消费:从 $5 起充值,一份余额同时支付工具和模型。上方卡片显示今日价格;价格页列出了每个工具。

07

常见问题

?
可以按城市或地址搜索吗?+

该工具只支持按邮政编码搜索。请把邮政编码放进 locations。

可以获取已成交房源和出租房源吗?+

可以。operation 接受 buy、rent 或 sold。

包含 Zestimate 吗?+

包含。工具说明中列出了每套房源的价格、卧室、卫浴、居住面积、地址和 Zestimate。

最多能获取多少套房源?+

maxItems 设置每次运行的数量,运行上限 max_results 最高 200 套房源。需要更多时,请发起多次运行。

可以按价格筛选吗?+

可以,用 minPrice 和 maxPrice。0 表示不限。

需要订阅吗?+

不需要。你向预付费余额充值,每次运行从中扣费。失败的运行只为已交付的结果付费,也不会自动续费。

在研究房地产市场?请参阅旅游与房地产数据、电商情报和工具目录。

一个预付费密钥,搞定模型、数据和智能体

无需订阅。充值后按需使用,每笔费用都能在日志中查看。