批量查询最多 50 个房产 ID 的详情
查看 Zillow 美国房产与市场数据 API 的全部接口 →body 为 JSON 对象，必填 zpids 数组含 1–50 个房产 ID。可选 include 在此处是数组，不是单套房查询所用的逗号分隔字符串。文档值为 photos、schools、similar、nearby、history、agent、affordability、zestimate_history。 文档描述每套房产独立返回成功或错误，整体可在 HTTP 200 下部分失败。没有已保存的批量房产响应，精确单项键、顺序与附件结构尚未验证。请保留提交 ID 并逐项检查结果身份，不能将 HTTP 200 当成全组合成功。单套房路由的空壳成功行为提示应核对身份，但并不能证明此批量接口用同样方式报告不存在记录。
API 功能
每批最多 50 个房产 将 1–50 个已知 zpid 放入文档规定的数组请求。
附件采用数组形式 批量 include 是 JSON 子资源名称数组，不能沿用单套房的逗号分隔写法。
房产结果逐项处理 文档允许整体 HTTP 200，但每个房产分别成功或失败。
按身份对账房产组合 更新组合前比较提交 ID 与可用返回身份，不依赖尚未验证的结果顺序。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
POST
/api/project/zillow-real-estate/batch-properties API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/zillow-real-estate/batch-properties?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"<body>"}'
curl -X POST 'https://api.opendata-api.com/api/project/zillow-real-estate/batch-properties?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"<body>"}' 查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 房产组合快照刷新：把已复核的已知 ID 分组补全，而非为所有发现结果自动获取详情。
- 房产失败队列：将失败或不可用记录与已接纳记录分开，再决定重试。
- 指定子资源导入：只请求组合审查所需的文档附件类别。
- 表格 ID 对账：按原始 zpid 行关联有效详情，不假设批量返回顺序。
常见问题
每次最多可以传多少个房产 ID？
zpids 必须含 1–50 个房产 ID，较大组合需拆成多次有边界的请求。此上限是请求规模约定，不代表完整数据覆盖。
此接口的 include 是字符串还是数组？
在批量 JSON body 中是数组，与单套房查询的逗号分隔参数不同。应提交含 zpids 和可选 include 的原始 JSON 对象。
HTTP 200 是否代表每套房产都已找到？
不是。文档允许部分失败和逐项结果，还需检查每项身份。精确批量结构与不存在 ID 的行为尚未实测。