Realtor 房源图片 API - 按地址或 property

query 可按文档填写已知房产 ID、支持的房源链接、完整地址或地址式 ID。可选 size 使用 w2048_h1536 形式；实际图片尺寸和缩放行为需验证。专用图片接口尚未实测，响应结构、图库字段和链接可用性均未确认。已实测的 property-v2-detail 曾返回 photos[].href，若同时需要完整房源详情可优先参考该接口。能读取图片链接不代表获得图片复用或再分发授权。

API 功能

独立图库查询入口 可单独评估图片查询，无需假定必须取得完整详情响应。

图库的多种房产输入 文档列出房产 ID、房源 URL、完整地址和地址式标识作为 query。

宽高格式的图片请求 size 可采用 w2048_h1536 等格式，但格式本身不保证返回对应像素尺寸。

图片链接与使用权分开核对 先确认实际图库字段和链接，再单独确定允许的图片展示与再分发范围。

在线 API 演示

GET /api/project/realtor/property-photos

API 响应 (JSON)

{}

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-photos?key=<API_KEY>&query=<query>'

curl -X GET 'https://api.opendata-api.com/api/project/realtor/property-photos?key=<API_KEY>&query=<query>'

📢

需要帮助？

如遇接口异常，或需要其他接口需求，可联系我们

联系我们

使用场景

评估所选房产的按需图库，避免为纯图片场景加载无关详情字段。
发布已获授权的收藏房源集合前，审核图片链接是否可用。
在媒体质量测试中比较不同 size 请求与实际图片尺寸。
记录房源卡片的图库缺失状态，不用未经核实的素材代替真实房源图片。

常见问题

可以通过完整地址获取房源图片吗？

文档允许完整地址作为 query，但此专用图片接口尚未实测。需要验证地址匹配、实际图片字段和链接可用性；不能承诺每个地址都有图库。

size=w2048_h1536 能保证图片就是这个尺寸吗？

不能。它是文档中的输入格式，实际缩放行为和像素尺寸未验证。请检查返回资源后再用于固定尺寸的展示设计。

获取到 photos 链接后可以直接转载吗？

不能仅据此认定获得授权。图片访问能力与版权、展示和再分发许可不同，正式使用前需确认相应权利。

使用指南

查看订阅方案 →

按房产 ID、地址或链接查询房源图库