按房产 ID 获取美国房源照片图库

查看 美国房产与房贷数据 API 的全部接口 →

通过必填的 property_id 查询参数,获取美国房产关联的照片;该标识应取自房源搜索结果。本接口不接受 listing_id,也没有分页控制、图片尺寸选择或文档列明的照片筛选参数。 实测成功响应中的匹配记录位于 data.home_search.results,而非直接位于 data.home。该次响应包含一条结果,带有 property_id、listing_id 以及 75 张照片,照片条目中可见图片 URL 和图片标签。请遍历 results 集合,将照片与返回的标识关联,并兼容空集合或缺少媒体的情况。75 张仅是某套房产的实测数量,不代表固定图库大小或照片覆盖保证。实测摘要未记录图片 URL 和标签的具体成员名,绑定图片组件前需先核对。 现有示例已被截断,且内容偏向房源列表;该示例未经验证,不能据此认定存在另一套响应结构。按房产标识查询,不代表照片始终属于某条固定挂牌记录,也不保证图片顺序固定或链接长期有效。返回的图片 URL 只是媒体访问引用,并非图片再分发或商业使用许可;存储或重新发布照片前,请先确认相关使用权。

API 功能

单一房产标识获取图库 仅需传入房源搜索结果中的必填 property_id 查询字符串,即可请求该房产关联的照片。
按实测图库层级读取照片 从 data.home_search.results 读取匹配记录,再读取其中的 photos,不假定返回结构与房产详情接口的 data.home 相同。
照片与房产挂牌记录关联 为每条图库结果保留返回的 property_id 和 listing_id,确保图片展示关联到对应记录。
图片链接与标签元数据 已检查的结果包含 75 张照片,照片条目中有图片 URL 和图片标签。使用前应核对具体成员名;图片数量与可用元数据可能因房产而异。
媒体访问与图片授权分开判断 将返回的照片链接视为媒体引用,而非允许再分发、缓存或商业使用图片的授权凭证。

在线 API 演示

GET /api/project/realty-in-us/properties-v3-get-photos

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/realty-in-us/properties-v3-get-photos?key=<API_KEY>&property_id=<property_id>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

获取房源照片需要传入什么参数?

将房源搜索返回的 property_id 作为必填查询字符串传入。本接口不接受 listing_id,也没有文档列明的照片筛选、图片尺寸或分页参数。

应用应从响应的哪个位置读取图库?

已验证的响应使用 data.home_search.results,实测结果中包含 property_id、listing_id 和 photos。请遍历 results 集合,不要假定它使用房产详情接口的 data.home 层级。

每套房产都会返回恰好 75 张照片吗?

不会。一次检查中,某套房产返回一条结果,其中有 75 张照片。该数量不代表图库大小固定、涵盖所有房产的完整照片,或保证照片一定可用。请处理空结果和缺少照片的情况。

照片条目中有图片 URL 和标签吗?

实测照片条目中同时出现了图片 URL 和图片标签,但实测摘要未记录其具体成员名或标签分类体系。渲染图片或根据标签设置分类名称前,请先核实这些细节。

按 property_id 查询能保证图片永久对应某条挂牌记录吗?

不能。实测响应虽然包含 listing_id,但按房产标识查询并不保证媒体内容不变、排序固定或链接永久有效。请将返回的标识与图库一并保存,并处理链接变更或不可用的情况。

返回的图片可以用于商业用途吗?

出现图片 URL 并不代表获得了再分发或商业使用许可。存储、重新发布照片或将其用于广告前,请先确认适用的图片使用权。

相关接口

相关指南

查看订阅方案 →