Despegar API

Real-time flights and hotels from Despegar — Latin America's leading OTA. Search live flight fares and hotel availability, with airport/city autocomplete, rich normalized results (segments, prices, ratings, amenities, photos) and per-hotel room rates.

原始信息汇总

数据集概述：Despegar API

描述： 一个实时航班和酒店数据API，数据来源于拉丁美洲领先的在线旅行社（OTA）Despegar。提供航班价格搜索、酒店可用性查询、机场/城市自动补全及酒店房间详情等功能，返回标准化的JSON数据。注意： 这是一个非官方API，与Despegar无关联或背书。

提供者信息：

• 创建者： tomasbarak
• 类别： Travel（旅游）
• 订阅者数： 2

API 指标：

• 受欢迎度： 8.9
• 服务级别： 89%
• 延迟： 10254ms
• 测试比例： 50%

定价计划：

• BASIC: $0.00/月
• PRO: $25.00/月
• ULTRA: $99.00/月
• MEGA: $399.00/月

---

核心功能

• 航班搜索： 支持单程和往返，可排序和过滤（按价格、时长、经停次数、航空公司、起飞时间等）。
• 最低票价： 轻量级单结果查询，用于价格比较。
• 酒店搜索： 分页结果，包含星级、客人评分、设施、照片和地理坐标。
• 房间费率： 每间酒店的房间类型，包括餐食计划、取消政策和完整价格明细。
• 自动补全： 将自由文本解析为机场/城市代码（航班）和城市/酒店ID（酒店）。
• 标准化JSON： 数据以标准化的JSON格式返回，支持缓存，支持多种货币。

典型使用流程

1. 解析地点： 使用 /v1/locations/search 获取 IATA 代码（航班）或地理ID（如 CIT_1569，用于酒店）。
2. 搜索： 使用 /v1/flights/search 或 /v1/hotels/search。
3. 钻取详情（酒店）： 使用搜索结果中的 id 和 roomPackId，通过 /v1/hotels/{id}/rooms 获取具体房间信息。

主要端点详情

1. 航班

• GET /v1/flights/search: 搜索航班。
  • 关键参数:
    • origin (必须): IATA城市/机场代码，例如 BUE。
    • destination (必须): IATA城市/机场代码，例如 MAD。
    • departDate (必须): 出发日期（YYYY-MM-DD）。
    • returnDate: 返回日期（可选，省略则为单程）。
    • adults: 成人数量（默认1）。
    • currency: 货币ISO代码（默认 USD）。
    • sort: 排序方式（price, duration, stops, departure）。
    • order: 排序顺序（asc, desc）。
    • nonStop: 仅直飞（true）。
    • maxPrice: 最高价格。
    • 其他：cabin, airlines, maxStops, maxDurationHours, departAfter, departBefore, limit等。
• GET /v1/flights/cheapest: 返回单个最便宜的匹配报价及摘要。参数与搜索端点相同。

2. 酒店

• GET /v1/hotels/search: 搜索住宿。
  • 关键参数:
    • destinationId (必须): 从地点搜索获取的地理ID，例如 CIT_1569。
    • checkIn (必须): 入住日期（YYYY-MM-DD）。
    • checkOut (必须): 退房日期（YYYY-MM-DD）。
    • adults: 每间房的成人数量（默认2）。
    • currency: 货币ISO代码（默认 USD）。
    • page: 分页（每页21条结果）。
• GET /v1/hotels/{id}/rooms: 获取特定酒店的房间类型和可预订费率。
  • 路径参数:
    • id (必须): 酒店ID，例如 356522。
  • 查询参数:
    • destinationId (必须)
    • checkIn / checkOut (必须)
    • roomPackId: 可选，来自搜索结果。

3. 地点（自动补全）

• GET /v1/locations/search: 将自由文本解析为代码/ID。
  • 关键参数:
    • q (必须): 搜索词，例如 cancun。
    • type: 类型，flights（返回IATA代码）或 hotels（返回城市/酒店地理ID）。默认为 flights。
  • 重要说明:
    • 航班：使用结果中的 code 作为 origin/destination。
    • 酒店：使用结果中的 gid 作为 destinationId。支持城市（CIT_）或区域（REG_），但不支持国家级别（COU_）。

认证方式

所有请求均通过 RapidAPI 进行。需要在每次调用时包含以下请求头：

• X-RapidAPI-Key: <your-rapidapi-key>
• X-RapidAPI-Host: <your-rapidapi-host>

错误响应

状态码	含义
400	无效/缺失参数（详情见响应体）
502	上游临时失败，请重试
503	上游暂时不可用，请稍后重试

数据备注

• 货币： 通过 currency 参数指定，价格将以该货币返回。
• 缓存： 相同搜索会被短时缓存，重复调用速度更快（响应头 x-cache: HIT/MISS）。
• 延迟： 首次（未缓存）搜索需要几秒钟；缓存后可在毫秒级返回。
• 分页（酒店）： 每次返回21条结果，可通过 page 参数获取更多。
• 日期格式： 始终使用 YYYY-MM-DD；returnDate/checkOut 必须在 departDate/checkIn 之后。