搜索酒店目的地，获取 entityId
查看 Skyscanner 天巡机票与酒店查询 的全部接口 →以必填 query 搜索酒店目的地，可选 market 与 locale。已测试的 places 建议包含 entityId、name、type、hierarchy 和 coordinates.lat/lng。Paris 曾返回法国巴黎城市（entityId 27539733），也包含机场、街区与酒店建议，其中有拉斯维加斯的同名酒店。先结合 hierarchy 与 type 确认地理范围，再把所选 entityId 用于酒店搜索。hierarchy 是以竖线分隔的描述文本，type 的大小写可能不同，不要强行按未经确认的完整枚举过滤。该接口只返回目的地建议，不提供指定日期的房间或价格。
API 功能
获取住宿搜索所需目的地 ID 选中建议后使用其 entityId 查询酒店，不根据用户输入的地名猜测编号。
地理层级区分跨地区同名地点 hierarchy 有助于区分法国巴黎与其他地区的同名酒店或地点，避免只看名称。
兼容多类型与不同大小写 已测试建议包含城市、机场、街区和酒店，type 大小写不同也不应导致有效建议丢失。
选定住宿区域前核对坐标 coordinates.lat/lng 可用于确认目标位置，再发起独立的入住日期搜索。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/skyscanner/hotels-search-destination API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/hotels-search-destination?key=<API_KEY>&query=<query>&market=US&locale=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/hotels-search-destination?key=<API_KEY>&query=<query>&market=US&locale=en-US'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 住宿目的地选择器：让用户明确选择巴黎城市，而不是机场或拉斯维加斯的同名酒店。
- 保存住宿搜索范围：保留 hierarchy 标签，说明候选条件针对某街区还是整个城市。
- 目的地到住宿搜索的参数衔接：先确定 entityId，再组织入住期、人数和房间数。
- 健壮的目的地类型处理：兼容大小写不同的 type，不误删街区或具体酒店建议。
常见问题
搜 Paris 时怎样选对巴黎，而不是同名酒店？
同时查看 name、type、hierarchy 与坐标，确认国家和地理范围后再选 entityId。已测试结果既包含法国巴黎，也包含其他地区的同名酒店；不要默认第一条就是所需城市，type 也可能使用不同大小写。
目的地建议能说明酒店有房或给出入住价格吗？
不能。此接口只解析城市、机场、街区或酒店等地点建议，不查询日期相关房间与价格。选定 entityId 后，还需在酒店搜索中传入入住退房日期与人数等条件，具体可用性以实际报价查询为准。