BookRetreats API

Access structured data on yoga, meditation, and wellness retreats worldwide via the BookRetreats API. Retrieve listings, pricing, availability, reviews, and detailed retreat profiles — ideal for wellness travel platforms, comparison tools, and market research applications.

原始信息汇总

BookRetreats API 数据集概述

基本信息

• 数据集名称: BookRetreats API
• 类别: Travel
• 提供者: kakoto
• API 版本: 1.0.0 (current)
• API 地址: https://rapidapi.com/kakoto-kakoto-default/api/bookretreats-api

数据集描述

该API提供对全球瑜伽、冥想和健康疗养中心的结构化数据访问。可检索列表、价格、可用性、评论和详细的疗养中心资料，适用于健康旅游平台、比较工具和市场研究应用。

技术指标

• 流行度: 8.7
• 服务等级: 100%
• 延迟: 3633ms
• 测试通过率: 100%

订阅计划

• BASIC: $0.00 / 月
• PRO: $15.00 / 月
• ULTRA: $49.00 / 月
• MEGA: $139.00 / 月

端点概览

1. 搜索疗养中心

• 端点: GET /tour/search
• 功能: 按地点和日期范围搜索疗养中心列表，支持排序和分页。
• 必需参数:
  • location: 城市、地区或国家名称（与BookRetreats URL中的显示一致）
  • start_date: 开始日期（YYYY-MM-DD格式）
  • end_date: 结束日期（YYYY-MM-DD格式）
• 可选参数:
  • sort_by: 排序字段（如 "dates.priceFrom", "rating", "duration", "distance"）
  • sort_direction: 排序方向（"asc" 或 "desc"）
  • page: 页码

2. 通过URL获取疗养中心详情

• 端点: POST /tour/get-by-url
• 功能: 使用完整的BookRetreats列表URL获取单个疗养中心的详细信息。
• 必需参数:
  • url: BookRetreats上疗养中心页面的完整URL

3. 通过URL获取疗养中心列表

• 端点: POST /tour/listing-by-url
• 功能: 使用完整的BookRetreats搜索页面URL检索疗养中心列表。
• 必需参数:
  • url: 包含所有查询参数的完整BookRetreats搜索URL

4. 获取疗养中心评论

• 端点: GET /tour/review
• 功能: 检索与地点和日期范围匹配的疗养中心的客座评论。
• 必需参数:
  • location: 城市、地区或国家
  • start_date: 日期范围开始（YYYY-MM-DD格式）
  • end_date: 日期范围结束（YYYY-MM-DD格式）
• 可选参数:
  • sort_by: 排序字段
  • sort_direction: 排序方向（"asc" 或 "desc"）
  • page: 页码（每页10条评论）

响应结构

所有响应共享一致的包装格式：

成功响应

json { "statusCode": 200, "messageCode": "OK", "data": [ /* 结果数组 */ ] }

错误响应

json { "statusCode": 400, "messageCode": "BAD_REQUEST", "message": "描述性错误信息" }

关键数据字段

• 疗养中心详情:

  • dates[].price_from: 疗养期间的起始价格
  • dates[].is_open_all_year: 疗养是否全年开放
  • accommodations: 可用房间/帐篷类型及价格
  • teachers: 教师简介
  • programs: 每日活动安排
  • meals / foods: 餐食类型和饮食选项
  • inclusions / exclusions: 包含和不包含的项目
  • facilities: 现场设施
  • cancellation_policy: 取消政策
  • atmospheres: 疗养氛围标签
  • age_groups: 适合的年龄范围
  • skill_levels: 技能水平适用性
  • airport_transfers: 最近机场及接送价格
  • faqs: 常见问题解答
  • rating_info: 详细评分细分

• 评论数据:

  • 包含子评分（食物、教师、住宿、沟通等）
  • 评论者国家
  • 主人回复
  • 评论照片

使用指南与最佳实践

1. 精确匹配地点值：location参数区分大小写，应与BookRetreats URL中的值完全一致。
2. 结合搜索与详情获取：先使用/tour/search高效识别疗养中心ID和URL，再对高优先级列表选择性调用/tour/get-by-url以获取完整信息。
3. 利用URL驱动的工作流：对于预构建的搜索URL，使用/tour/listing-by-url端点直接复制结果。
4. 评论分页处理：/tour/review端点每页返回10条评论，可通过分页收集所有可用评论。
5. 处理全年开放和灵活日期列表：注意is_open_all_year: true的列表，并通过dates[].price_from和spots_available筛选可预订选项。

常见错误场景

• 400 Bad Request：缺少必需参数或日期格式错误。
• 404 Not Found：无效的URL路径或已下架的疗养中心。
• 500 Internal Server Error：上游页面提取失败。