遇见数据集

Airbnb API

收藏
RapidAPI2026-08-03 更新2026-08-04 收录
官方服务:

资源简介:

Airbnb API, unlimited

创建时间:
2026-08-03
原始信息汇总

数据集概述

Airbnb API 是一个提供 Airbnb 数据访问功能的 REST API,旨在帮助开发者通过简单接口搜索房源、解析目的地、获取房源详情、检查可用性以及获取结算价格。该 API 由开发者 cavsn 创建,归类于 Travel 类别,当前订阅者数量为 2。


基本信息

  • 版本:0.1.0(当前版本)
  • 基础 URLhttps://airbnb-api22.p.rapidapi.com
  • 认证方式:通过 RapidAPI 提供的标准请求头进行认证,包括:
    • X-RapidAPI-Key
    • X-RapidAPI-Host

响应格式

  • 大多数响应包含 statussource 字段,其中 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 开始。
    • 示例响应包含 statussourcetotalresults(含 idurltitlecoordinatesrating 等)和 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&currency=USD
    • 必需参数:id(Airbnb 房源 ID,也可接受 propertyIdlistingIdroomId)。
    • 可选参数:check_incheck_outadultscurrencyraw(用于调试的原始载荷开关)。
    • 示例响应包含房源名称、类型、容量、评分、位置、照片、预订数据和可选日期。
  • 获取结算价格

    • GET /api/v1/getPropertyCheckoutPrice?id=26119973&check_in=2026-09-01&check_out=2026-09-05&adults=2&currency=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

实用说明

  • 搜索结果通常包含 resultsmapResults 两部分。
  • 搜索返回的房源 ID 可直接用于房源详情端点。
  • 当提供日期时,搜索显示价格能可靠获取。
  • 结算价格和可用性需要提供 idcheck_incheck_out 参数。
  • 单条评价正文无法通过 Airbnb 初始公共页面载荷获取,但评价总数、评分类别、分布和标签在可用时可被暴露。
  • 应仅在调试时使用 raw=true,因为原始载荷可能很大。
二维码
社区交流群
二维码
科研交流群
商业服务