GlampingHub API

Retrieve structured glamping listings worldwide from GlampingHub — including pricing calendars, amenities, reviews, and location data. Built for travel tech developers, outdoor accommodation aggregators, and hospitality market researchers.

原始信息汇总

GlampingHub API 数据集概述

基本信息

• 数据集名称: GlampingHub API
• 类别: 旅行
• 提供者: kakoto
• API版本: 1.0.0 (current)

服务评级

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

订阅计划与定价

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

概述

GlampingHub API 提供全球范围内结构化奢华露营（Glamping）房源列表的检索，包括价格日历、设施、评论和位置数据。专为旅行科技开发者、户外住宿聚合商和酒店市场研究人员构建。

API端点

1. 通过URL获取房源详情

• 端点: POST /property/get-by-url
• 功能: 使用GlampingHub房源页面的完整URL获取单个奢华露营房源的全面详情。返回结构化、兼容schema.org的数据，包括地理坐标、照片、评论、设施、价格信息和房屋规则。
• 必需输入参数:
  • url: 房源页面在GlampingHub上的完整URL（包括任何搜索上下文查询参数）。

2. 通过URL获取房源列表

• 端点: POST /property/listing-by-url
• 功能: 从GlampingHub搜索结果页面URL检索奢华露营房源列表。返回适用于列表视图的卡片级数据，包括按日期范围细分的价格日历、特色标签、类别和可用性指示器。
• 必需输入参数:
  • url: 完整的GlampingHub搜索结果URL（包括所有筛选器和分页参数）。

响应结构

所有响应遵循一致的格式。

成功响应

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

错误响应

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

常见状态码: 200 成功, 400 错误请求, 404 未找到, 500 服务器错误。

关键数据字段示例

房源详情端点返回字段示例

• identifier: 唯一数字房源ID
• geo: 纬度/经度坐标
• address: 地点、国家、邮政编码
• aggregate_rating: 总体星级评分和评论数量
• price_range: 人类可读的起始价格字符串
• amenity_feature: 设施对象数组（Wi-Fi、厨房、停车位、取消政策、最短住宿时间等）
• review: 包含作者、正文、评分和日期的客人评论数组
• image: 全分辨率照片URL数组

房源列表端点返回字段示例

• id: 唯一房源ID
• name_en / name_es: 英文和西班牙文房源标题
• category_en: 奢华露营类型（例如，蒙古包、狩猎帐篷、树屋）
• location: 城市、州、国家、大陆和GPS坐标字符串
• rate_from_int / rate_from_int_usd: 当地货币和美元的最低每晚价格
• estimated_rate: 请求日期的定价对象（总价、净价、服务费、最短住宿时间、免费取消截止日期）
• remarkable_features: 房源卡片上显示的前3个特色设施标签
• absolute_url_en: 完整房源页面的相对路径

使用指南与最佳实践

1. 从浏览器构建搜索URL：最可靠的方法是直接在网站上执行搜索，并将生成的URL复制到url参数中。
2. 使用listing-by-url进行发现，使用get-by-url进行丰富：列表端点返回多个房源的轻量级卡片数据，适用于构建索引或监控可用性。识别目标房源后，使用详情端点提取完整描述、客人评论、地理坐标和完整的设施集。
3. 理解estimated_rate中的定价模型。
4. 通过URL中的page参数进行分页。
5. 检查nested_features以获取详细的设施逻辑。

常见错误场景

• 400 Bad Request: URL格式错误或缺少必需的url字段。
• 404 Not Found: 房源已下架或URL路径无效。
• 500 Internal Server Error: 页面结构更改或提取失败。