查询文字房源系列的详情资料
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →必须提供十进制房源 id,可选 currency 和 locale。较早房源搜索示例从 homes[].listing.id 取值,当前实测则使用 demandStayListing 标识;不要假定旧路径仍存在,也不要把编码标识当作十进制 ID。文档详情 data 类型为 StayPDPSections,含 metadata、bookingPrefetchData 及 seoFeatures 中的 canonicalUrl 和房源说明。未指定日期时,价格相关元数据可能为 null。此详情接口未单独实测,不应与已验证的 stays-detail 混淆。
API 功能
文字房源系列的 id 入参 此接口使用 id、currency、locale,而非 listingId、currencyCode、languageCode。
房源元数据补充 文档 StayPDPSections 包含用于补充档案的元数据和介绍信息。
规范房间链接核验 通过文档结构中的 metadata.seoFeatures.canonicalUrl 核对原始房源身份。
容忍无日期价格信息为空 未传日期时,不依赖 bookingPrefetchData.price 一定有值。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/properties-detail API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/properties-detail?key=<API_KEY>&id=<id>¤cy=USD&locale=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/properties-detail?key=<API_KEY>&id=<id>¤cy=USD&locale=en-US'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 解析出正确十进制 ID 后,为文字搜索发现的房源补充文档所述档案。
- 在分析师的房源研究记录中附上返回的规范房间链接以供核查。
- 在住宿数据库中区分静态房源元数据和指定日期报价观察。
- 当前搜索改用其他标识结构时,检查旧 homes[].listing.id 集成是否仍适用。
常见问题
properties-detail 应填写哪个 ID?
此接口需要十进制房源 id。较早文档中的房源搜索显示 homes[].listing.id,但当前实测 homes 样本没有该字段。请检查实际标识并解析正确的十进制 ID,不要原样转发编码后的 demandStayListing.id。
这就是已经验证过的 stays-detail 吗?
不是。这是独立的文字房源系列接口,使用 id、currency、locale。虽然有文档示例,本次实测验证的是使用 listingId 的 stays-detail,而不是此接口。