读取当前返回的优选住宿档次筛选项
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →提供目的地 query，可选 language_code，读取文档所述的优选住宿目录。示例响应含 status、message，以及带 id、title、subtitle 的档次选项。历史名称不保证当前仍提供；在 properties-search.top_tier_stays 使用 ID 前先查看实际返回。此接口未纳入本次实测。优选分组只是搜索类别，不是独立质量保证、服务权益或特殊预订权限。
API 功能
优选住宿筛选 ID 发现 文档响应将目的地对应的档次标识与说明性标题配对。
档次副标题辅助理解 示例 subtitle 可解释返回类别的呈现含义。
审慎使用历史档次名称 未检查新响应前，不把较早命名档次硬编码为现有产品。
档次分组不提供质量担保 档次是筛选元数据，不独立核实品质，也不安排服务。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/get-top-tier-stays-filter API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/get-top-tier-stays-filter?key=<API_KEY>&query=New+York%2C+NY&language_code=en-US'
curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/get-top-tier-stays-filter?key=<API_KEY>&query=New+York%2C+NY&language_code=en-US'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 仅用目的地当前实际返回的选项填充优选住宿选择器。
- 历史档次消失或改名时，检查旧优选类别集成。
- 为文字房源系列 top_tier_stays 解析返回 ID，而不硬编码名称。
- 解释返回的优选分组，同时明确它不代表质量保证或服务权益。
常见问题
可以假定旧示例中的档次名称现在仍可用吗？
不可以。提供的示例包含历史档次名称，此接口也未纳入本次实测。请读取当前目的地目录，只展示确实返回的选项。
这些 ID 与 stays-search.topTierStays 的值相同吗？
不要假定相同。此目录属于文字房源系列的 top_tier_stays；stays-search 单独声明了 guest_favorite、luxe 等值。请遵循实际调用接口的约定。