按地点与筛选条件搜索美国房源
查看 Zillow 美国房产与市场数据 API 的全部接口 →在 location 中填写城市、邮编或地址，再按房源状态、价格、卧室、卫浴、房型、设施及可负担性筛选。status 支持 for_sale、for_rent、sold；result_type 支持 list、map。page 从 1 开始，文档上限为 1000；也可使用 cursor 续查。同一搜索翻页时保持筛选条件不变，并限制总请求数。 已保存的 Seattle 列表响应含 success、data.results、data.total_count，另有与 data 并列的 pagination，内含 result_count、current_page、has_next、next_cursor。房源字段包括 zpid、地址、城市、州、邮编、价格、卧室、卫浴、面积、房型、状态、房价及租金估值、经纬度与图片和详情链接。page_size=3 时返回了 3 条；字段与估值可能为空，样本还出现负数 days_on_zillow，不应当作可靠的挂牌天数。 无法识别的地点曾返回 HTTP 200，但 success:false、error.code:INVALID_LOCATION、error.param:location，且无房产数据。应与有效地点没有符合条件的房源区分。仅所述列表首屏已实测，全部筛选组合、地图输出及后续分页未逐一验证。
API 功能
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
/api/project/zillow-real-estate/search-properties API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/zillow-real-estate/search-properties?key=<API_KEY>&status=for_sale&page=1&page_size=40&result_type=list&sort=relevance'
查询结果
使用场景
- 购房候选清单：按地点筛选房源，让用户选择哪些 zpid 需要进一步补全详情。
- 出租库存观察：比较相同地点、相同状态的带日期快照，不宣称覆盖全部出租住房。
- 房源结果展示：呈现挂牌价、卧室卫浴数量及坐标，估值缺失时仍保留为空。
- 地点输入诊断：遇到 INVALID_LOCATION 时提示修改输入，而不是显示空房源页。
常见问题
房源列表与分页字段分别在哪里？
实测列表在 data.results，数量在 data.total_count；pagination 是与 data 并列的对象，包含 result_count、current_page、has_next、next_cursor。
HTTP 200 是否说明地点有效？
不是。无法识别的地点曾返回 HTTP 200、success:false 和 error.code:INVALID_LOCATION。读取房源数据前先判断内部业务结果。
应该用 page 还是 cursor 翻页？
文档将两者列为可选方式。可从 page=1 开始，或原样使用返回的 cursor，保持筛选不变并在分页耗尽时停止。目前只验证了列表首屏，未验证后续游标行为。