如果你投资出租房、作为经纪人给房子定价,或者要做市场报告,就需要知道某个邮政编码区域内的房子挂牌多少钱、成交多少钱、租金多少,而且是本月的数据,不是季度 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>工作原理
列出你的邮政编码
选出你关注的街区的邮政编码:你持有房产的地方、你想买房的地方、你的客户居住的地方。
设置上限后运行工具
发送到
POST /v1/tools/zillow-listings/run,把operation设为buy、rent或sold,用maxItems指定房源数量,并用max_results作为运行上限。运行会从你的余额中预留它的最高费用,并以 JSON 返回房源。计算并对比
对每个邮政编码,计算价格中位数、每平方英尺居住面积的价格,以及与 Zestimate 的差距。带上日期保存,逐月对比。
一次请求获取邮政编码下的房源
搜索 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 套房源。
每套房源包含什么
| Field group | What you get |
|---|---|
| 价格 | 挂牌价或成交价 |
| 规模 | 卧室、卫浴和居住面积 |
| 位置 | 地址 |
| 估值 | Zillow 的 Zestimate |
使用方案
每月 1 日,对你追踪的每个邮政编码运行 buy,存储挂牌价中位数和房源数量,并画成图表。
对同一个邮政编码分别运行 rent 和 buy,比较典型租金与每间卧室的典型价格,找出适合出租的区域。
对该邮政编码运行 sold,保留卧室、卫浴和居住面积相近的房子,把它们的价格作为参照。
对 buy 的结果,计算挂牌价与 Zestimate 的比值,列出远高于它的房源。
设置 minPrice 和 maxPrice,每天早上把新房源发给自己。
更想用自然语言?连接 MCP 服务器,然后告诉 Claude Code 或 Cursor:"对邮政编码 78701、78702 和 78704,各获取 40 套在售房源,展示价格中位数、居住面积中位数,以及与 Zestimate 差距的中位数。把 max_results 设为 120。"
与其他数据源搭配
房源是供给端。围绕它还有:
按搜索 URL 获取 Zillow 房源:价格、卧室、浴室、地址、Zestimate 估值。
某地点及日期的 Airbnb 房源:价格、评分、房东、设施。
按关键词和地点在 Google 地图上查找商家:名称、地址、电话、网站、评分、评论数、营业时间、坐标。
Google 新闻中某个搜索的新闻文章(支持运算符:"精确短语"、OR、-排除词、site:、intitle:),可限定时间范围:标题、来源、日期及发布网站上的文章链接。
某关键词随时间及按地区的 Google 趋势热度。
airbnb-listings显示短租价格,可与长租租金对比。google-maps-places列出房产周边的商店、学校和配套设施。google-news追踪会影响市场的本地新闻,比如新进驻的雇主。google-trends显示对某个城市的搜索热度是否在上升。
如需同时看旅游和房产数据,请参阅旅游与房地产数据。
费用说明
按房源计费:开始运行时会预留最高费用,即单次调用费加上单套房源费乘以 max_results,运行结束后按实际返回的数量结算,其余预留金额退回你的余额。失败或超时的运行只为已交付的房源付费,开始时就被拒绝的运行不收费。
追踪 12 个邮政编码、每个 50 套房源,按 600 套房源计费。没有订阅,也没有每月最低消费:从 $5 起充值,一份余额同时支付工具和模型。上方卡片显示今日价格;价格页列出了每个工具。
常见问题
可以按城市或地址搜索吗?+
该工具只支持按邮政编码搜索。请把邮政编码放进 locations。
可以获取已成交房源和出租房源吗?+
可以。operation 接受 buy、rent 或 sold。
包含 Zestimate 吗?+
包含。工具说明中列出了每套房源的价格、卧室、卫浴、居住面积、地址和 Zestimate。
最多能获取多少套房源?+
maxItems 设置每次运行的数量,运行上限 max_results 最高 200 套房源。需要更多时,请发起多次运行。
可以按价格筛选吗?+
可以,用 minPrice 和 maxPrice。0 表示不限。
需要订阅吗?+
不需要。你向预付费余额充值,每次运行从中扣费。失败的运行只为已交付的结果付费,也不会自动续费。