获取海滨、小屋等爱彼迎主题类别
查看 Airbnb 爱彼迎房源、房价与评论查询 的全部接口 →提供目的地 query,可选 language_code,读取主题类别目录。文档响应含 status、message,以及 data 各项的 id、title、image。示例主题包括海滨、小屋、袖珍小屋、绝美景观和湖畔。将实际返回的类别 id 用于 properties-search.category,不要自造标签,也不要假定某主题始终可用。此元数据接口未纳入本次实测。主题类别用于发现,不是建筑物业分类或房源质量保证。
API 功能
目的地主题发现目录 文档类别按发现主题分组,不局限于常规建筑类型。
主题名称与图片配套 文档每项在机器 ID 之外,还提供 title 和 image。
单个主题映射 category 将一个返回类别 ID 用于文字房源系列 category,发起主题搜索。
可刷新的主题选择 读取当前目的地目录,不假定旧主题名称仍可选。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/airbnb-search/get-category API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/airbnb-search/get-category?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-category?key=<API_KEY>&query=New+York%2C+NY&language_code=en-US'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 用返回的海滨、小屋或袖珍小屋选项搭建目的地发现导航。
- 刷新主题类别图片与名称,而不是硬编码永久目录。
- 让旅客将文字房源搜索切换到某个实际返回的主题类别。
- 在旅行界面中区分主题发现标签与公寓、房屋等建筑分类。
常见问题
一条主题类别记录包含什么?
文档响应为每个主题选项提供 id、title、image。应将当前返回 id 作为房源搜索 category 值,不要发送标题或自行构造标签。
小屋等主题类别可以替代 property_type 吗?
不能。类别是发现主题分组,property_type 是独立建筑类型筛选。主题可用性与名称可能变化,且此类别接口未纳入本次实测。