Airbnb API
收藏官方服务:
资源简介:
Airbnb API, unlimited
创建时间:
2026-08-03
原始信息汇总
数据集概述
Airbnb API 是一个提供 Airbnb 数据访问功能的 REST API,旨在帮助开发者通过简单接口搜索房源、解析目的地、获取房源详情、检查可用性以及获取结算价格。该 API 由开发者 cavsn 创建,归类于 Travel 类别,当前订阅者数量为 2。
基本信息
- 版本:0.1.0(当前版本)
- 基础 URL:
https://airbnb-api22.p.rapidapi.com - 认证方式:通过 RapidAPI 提供的标准请求头进行认证,包括:
X-RapidAPI-KeyX-RapidAPI-Host
响应格式
- 大多数响应包含
status和source字段,其中source通常为airbnb_web。 - 如果 Airbnb 页面被阻止、更改或省略,API 会返回包含
status: false和错误描述的消息。 - 响应数据可能因位置、日期、房源状态、货币和 Airbnb 页面实验而有所变化。
端点概览
| 端点类型 | 端点名称 | 功能描述 |
|---|---|---|
| 元数据端点 | GET /api/v1/test |
检查 API 是否运行。 |
GET /api/v1/getCategory |
获取支持的类别元数据。 | |
GET /api/v1/getCurrency |
获取常用货币代码。 | |
GET /api/v1/getLanguages |
获取支持的语言元数据。 | |
| 筛选端点 | GET /api/v1/getAccessibility |
获取无障碍设施筛选选项。 |
GET /api/v1/getAmenities |
获取便利设施筛选选项。 | |
GET /api/v1/getHostLanguage |
获取房东语言筛选选项。 | |
GET /api/v1/getPropertyType |
获取房源类型筛选选项。 | |
GET /api/v1/getTopTierStaysFilter |
获取“宾客喜爱”、“超赞房东”等顶级筛选选项。 | |
GET /api/v1/getTypeOfPlace |
获取整租房源、独立房间、共享房间筛选选项。 | |
| 搜索端点 | GET /api/v1/searchDestination |
解析位置查询并返回 Airbnb 目的地元数据。 |
GET /api/v1/searchPropertyV2 |
按位置搜索房源。 | |
GET /api/v1/searchPropertyByLocationV2 |
按位置搜索房源(等价端点)。 | |
GET /api/v2/searchPropertyByLocation |
按位置搜索房源(等价端点)。 | |
GET /api/v1/searchPropertyByPlace |
按位置搜索房源(等价端点)。 | |
GET /api/v2/searchPropertyByPlaceId |
按目的地 ID 搜索房源。 | |
GET /api/v2/searchPropertyByGEO |
按坐标搜索房源。 | |
| 房源端点 | GET /api/v2/getPropertyDetails |
获取房源详情,包括照片、设施、评分、政策、位置、描述和预订数据。 |
GET /api/v1/getPropertyCheckoutPrice |
获取房源的实时结算价格。 | |
GET /api/v1/checkAvailability |
检查指定日期的房源可用性。 | |
GET /api/v1/getPropertyReviews |
获取房源评价数据。 |
主要功能详情
1. 元数据端点
GET /api/v1/getCurrency示例: json { "status": true, "data": [ { "code": "USD", "name": "United States dollar", "symbol": "$" }, { "code": "EUR", "name": "Euro", "symbol": "€" } ] }
2. 筛选端点
GET /api/v1/getAmenities示例: json { "status": true, "data": [ { "id": 4, "name": "Wifi" }, { "id": 8, "name": "Kitchen" } ] }
3. 搜索端点
-
搜索目的地:
GET /api/v1/searchDestination?query=Lisbon,返回目的地 ID、名称、坐标和精度。 -
按位置搜索房源:
- 主要端点:
GET /api/v1/searchPropertyV2 - 常见查询参数包括:
location:位置文本(如Lisbon, Portugal),可选。checkin/checkout:入住/退房日期,可选。adults/children/infants/pets:旅客人数,可选。currency:货币代码,可选。limit:请求的网格结果数量,默认 18。page:页码,从 1 开始。
- 示例响应包含
status、source、total、results(含id、url、title、coordinates、rating等)和mapResults。
- 主要端点:
-
按坐标搜索房源:
GET /api/v2/searchPropertyByGEO?lat=38.7222524&lng=-9.1393366- 必需参数:
lat(纬度)、lng(经度)。 - 可选参数:
radius_delta(坐标边界框增量)、zoom_level(地图缩放级别)。
4. 房源端点
-
获取房源详情:
GET /api/v2/getPropertyDetails?id=26119973&check_in=2026-09-01&check_out=2026-09-05&adults=2¤cy=USD- 必需参数:
id(Airbnb 房源 ID,也可接受propertyId、listingId、roomId)。 - 可选参数:
check_in、check_out、adults、currency、raw(用于调试的原始载荷开关)。 - 示例响应包含房源名称、类型、容量、评分、位置、照片、预订数据和可选日期。
-
获取结算价格:
GET /api/v1/getPropertyCheckoutPrice?id=26119973&check_in=2026-09-01&check_out=2026-09-05&adults=2¤cy=USD- 返回实时价格、折扣、原始价格、日期范围、可用性和即时预订功能。
-
检查可用性:
GET /api/v1/checkAvailability?id=26119973&check_in=2026-09-01&check_out=2026-09-05&adults=2- 返回房源可用状态、最大容纳人数、日期列表及说明(如单独日单元格可能不可用)。
-
获取评价:
GET /api/v1/getPropertyReviews?id=26119973- 返回评价总数、评分平均值和计数,但不提供单条评价正文,因为 Airbnb 初始公共页面载荷不包含该数据。
废弃端点
以下旧版路由仍可用,但新集成应使用推荐的 V2 端点:
| 废弃端点 | 推荐端点 |
|---|---|
GET /api/v1/getPropertyDetails |
GET /api/v2/getPropertyDetails |
GET /api/v1/searchProperty |
GET /api/v1/searchPropertyV2 |
GET /api/v1/searchPropertyByLocation |
GET /api/v2/searchPropertyByLocation |
GET /api/v1/searchPropertyByGEO |
GET /api/v2/searchPropertyByGEO |
实用说明
- 搜索结果通常包含
results和mapResults两部分。 - 搜索返回的房源 ID 可直接用于房源详情端点。
- 当提供日期时,搜索显示价格能可靠获取。
- 结算价格和可用性需要提供
id、check_in和check_out参数。 - 单条评价正文无法通过 Airbnb 初始公共页面载荷获取,但评价总数、评分类别、分布和标签在可用时可被暴露。
- 应仅在调试时使用
raw=true,因为原始载荷可能很大。




