Zillow 房源搜索
/zillow.search按城市、邮编、县或社区等区域搜索 Zillow 出售、出租或已售房源,可按价格、卧室数量、居住面积、房屋类型、发布时间及排序筛选,以规范化 JSON 返回价格、地址、卧室及卫浴数量、居住面积、状态和 Zestimate 估值。
- 最近 7 天完成的调用
- 0
统计不包含取消的调用。执行时间仅统计成功调用。
通过你的 Agent 使用
请安装 https://www.agentrouter.to/SKILL.md,然后通过 AgentRouter 使用 AnyAPI 的 /zillow.search 接口。
输入参数
limit选填- 返回结果数上限(1-25,默认 25)。
sortBy选填- 结果排序方式;省略则使用 Zillow 默认相关性。rentalPriorityScore 仅适用于租房搜索(例如 newest)。
location必填- 要搜索的区域级位置:ZIP 邮编、城市和州、县或社区(例如 'Austin, TX' 或 '78701')。不支持街道地址,请改用房产 ZIP 邮编。
maxPrice选填- 最高价格,单位为 USD:租房为月租,购房/已售为总价(例如 750000)。
minPrice选填- 最低价格,单位为 USD:租房为月租,购房/已售为总价(例如 250000)。
homeTypes选填- 按房产类型筛选;省略则不限。租房仅支持 singleFamily、multiFamily、townhome 和 condo(例如 ["singleFamily", "condo"])。
operation选填- 挂牌类型:buy(在售)、rent 或 sold。
maxBedrooms选填- 最多卧室数(例如 5)。
minBedrooms选填- 最低卧室数(例如 3)。
daysOnZillow选填- 仅包含在 Zillow 上挂牌不超过此时长的房源(例如 1_week)。
listingTypes选填- 购房搜索包含的挂牌类型;省略则包含所有标准类型。fsba = 经纪人挂牌,fsbo = 业主自行出售。租房和已售模式忽略(例如 ["newConstruction"])。
requireFields选填- 可选;省略时保持原路由,由最便宜的数据源提供结果。 指定本次请求必须能够返回的字段,如 `yearBuilt`;只会使用能提供全部指定字段的数据源。 未指定的字段,只要当前数据源提供,也仍会返回。 这可能提高费用:若最便宜的数据源无法返回指定字段,会改用较贵的数据源,并按该来源的价格报价和计费。 若刊登记录本身确实没有某个指定字段,该字段仍可能缺失。 若指定的字段组合无法由任何单一数据源同时提供,会作为无效输入拒绝且不计费。
maxLivingAreaSqft选填- 最大居住面积,单位为平方英尺(例如 3000)。
minLivingAreaSqft选填- 最小居住面积,单位为平方英尺(例如 1500)。
includeRoomForRent选填- 租房搜索是否包含单间出租;省略或 false 仅返回整套房源(例如 true)。
showOnlyPriceReductions选填- 仅显示降价房源。仅适用于购房搜索,租房忽略(例如 true)。
includeAcceptingBackupOffers选填- 包含接受备选报价的房源,Zillow 默认排除此类房源(例如 true)。
includePendingAndUnderContract选填- 包含交易待完成和已签约房源,Zillow 默认排除此类房源(例如 true)。
preferLatencyUnderMs选填- 可选;省略时保持原路由,由最便宜的数据源提供结果。优先选择典型响应时间低于指定毫秒数的数据源,再从中选择最便宜的一个;典型响应时间指该接口数据源健康信息公布的过去 30 天响应时间中位数。这可能提高费用:如果最便宜的数据源无法达到目标,会改用更快但更贵的数据源,并按该来源的价格报价和计费。若没有数据源满足速度目标,仍会选择性价比最高的数据源完成请求,不会仅因速度慢而拒绝。尚未计时的数据源最后尝试。这只是偏好,不是保证:中位数描述历史请求,不是本次请求的耗时上限,也不包括请求本身要求的等待时间。对分页查询,该偏好仅用于第一页;后续页继续使用第一页所选的数据源及其报价。
source选填- 可选。按优先顺序指定数据源 ID,取值来自 /catalog 或 /apis 中该接口的 `lanes[].source.id`。省略时使用最便宜的数据源,并支持自动故障切换。除非 `allowFallbacks` 为 false,否则先按给定顺序尝试列表中的来源,再尝试其他来源。仅指定一个来源且将 `allowFallbacks` 设为 false 时,只会由该来源按其价格提供结果,准确报价和计费,不会切换。报价取所有可能被使用的数据源中的最高价。不支持该接口的数据源 ID 会作为无效输入拒绝且不计费;列表中当前不可用的数据源也会被拒绝且不计费,省略 `source` 可改用其他来源。分页查询的后续请求必须继续包含第一页使用的数据源,或省略 `source`。
allowFallbacks选填- 可选,默认为 true。设为 false 时,只允许 `source` 中列出的来源提供结果;若没有来源能提供服务,则拒绝请求且不计费。设为 true 时先尝试列出的来源,之后可按正常价格尝试其他来源。
ignoreSources选填- 可选。指定本次请求要跳过的数据源 ID,取值来自该接口的 `lanes[].source.id`。使用剩余来源中最便宜的一个,报价则取剩余来源中的最高价。不支持该接口的数据源 ID,或同时出现在 `source` 中的 ID,都会作为无效输入拒绝且不计费;跳过全部来源也会以同样方式拒绝。
输入示例
{
"limit": 3,
"location": "Austin, TX",
"maxPrice": 900000,
"operation": "buy",
"minBedrooms": 3
}输出
AnyAPI 输出:found (布尔值), data (记录);未找到结果时包含 reason。