批量提交最多 10 组房源搜索
查看 Zillow 美国房产与市场数据 API 的全部接口 →body 为 JSON 对象，包含 1–10 个查询对象组成的 searches 数组。每项保存各自的 location 和所支持的筛选条件，例如 status、page、page_size。应用端应保留每组原始查询与处理结果的关联。 文档允许 HTTP 200 下部分失败，每组搜索各有成功或错误结果。此批量路由未实测，精确响应键和返回顺序尚未观察。不能将 HTTP 成功视为所有搜索成功，也不能把失败与有效但无结果的区域混在一起。先检查原因，再在客户端请求预算内选择性重试。
API 功能
每批最多 10 组查询 searches 接受 1–10 个文档支持的搜索对象，不是无限量跨市场查询。
结构化搜索数组 发送一个原始 JSON 对象，保留嵌套查询的对象类型与 searches 的数组类型。
逐查询隔离失败 文档允许个别搜索失败，同时整体 HTTP 请求仍成功。
保留查询来源 将每组地点、筛选组合和结果关联保存，避免丢失失败市场的身份。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
POST
/api/project/zillow-real-estate/batch-search API 响应 (JSON)
{} curl -X POST 'https://api.opendata-api.com/api/project/zillow-real-estate/batch-search?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-search?key=<API_KEY>' \
-H 'Content-Type: application/json' \
-d '{"body":"<body>"}' 查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 多城市库存比较：提交有数量边界的市场查询，并将每个城市保留为独立研究分组。
- 待售与待租分组：分别提交不同状态查询，不混淆各自房源集合。
- 搜索工作表执行：将已复核的地点和筛选行整理为小批 JSON 请求。
- 选择性重试队列：先区分失败查询与有效空结果，再安排后续尝试。
常见问题
批量搜索的 body 应该是什么格式？
使用带 searches 数组的 JSON 对象，数组含 1–10 个查询对象，每项提供地点及文档支持的筛选。body 承载序列化 JSON 对象，不是逗号分隔的地名。
HTTP 200 是否证明十组搜索都成功？
不是。文档允许整体 HTTP 成功而单项返回成功或错误，应逐项检查；精确字段和顺序未实测。
可以立即合并所有返回房源吗？
先保留每个结果对应的原始查询，将失败与有效空区域分开。确需合并时，再由应用按可用房产 ID 去重。