Hostelworld API

Search, price, and review hostels worldwide — live data from Hostelworld.com across 36,000+ properties, 169 countries, and 13M+ reviews through a single REST API.

原始信息汇总

Hostelworld API 数据集概述

数据集基本信息

• 数据集名称: Hostelworld API
• 提供平台: RapidAPI
• 类别: Travel
• 提供者: camazotz
• 当前版本: 1.0.0
• 访问方式: REST API
• 认证: 单一 RapidAPI 密钥
• 速率限制: 30 请求/分钟

数据内容与覆盖范围

• 数据源: Hostelworld.com（全球最大的旅舍预订平台）
• 覆盖范围: 169 个国家，超过 36,000 家旅舍，超过 1300 万条评论
• 核心数据类型:
  • 旅舍物业列表与实时定价
  • 房间级可用性
  • 旅行者评论（含人口统计信息）
  • 旅舍组织的社交活动（"linkup" 活动）
  • 地理层级结构（大洲 → 国家 → 城市）
  • 城市级统计信息
  • 活跃促销活动

主要功能特性

• 实时物业搜索与定价: 可按城市、入住日期、住宿晚数和客人数量搜索旅舍，返回宿舍床位和私人房间的实时最低夜间价格（支持任何主要货币）。
• 七类别评分细分: 提供 Hostelworld 专有的评分系统，涵盖安全、位置、员工、氛围、清洁度、设施和性价比七个类别。
• 旅行者评论数据: 提供分页评论，包含全文、语言代码、机器翻译标志以及旅行者人口统计数据（团体类型和年龄组）。
• 社交活动数据: 提供旅舍组织的聚会活动详情，包括名称、描述、开始/结束时间、地点、容量、参与者数量、价格和类别。此数据为其他 API 所不具备的独特数据。
• 房间级可用性: 可查询特定物业、日期和客人数量下的可用房型、每夜价格、总价、押金要求和取消政策。
• 完整物业详情: 包含所有房型、设施、照片、政策和预订条款的完整物业资料。
• 目的地层级结构: 完整的大洲 → 国家 → 城市树状结构，用于构建地理导航和目的地选择器。
• 城市级统计: 每个城市的物业数量、可用物业数量、总评分和免费取消可用性。
• 自动完成搜索: 通过部分名称进行即时目的地匹配，返回城市 ID 和坐标，实现无缝的搜索到预订流程。
• 活跃促销活动: 实时列出正在运行促销折扣的物业，包含折扣百分比和位置元数据。
• 无需上游凭证: 一个 RapidAPI 订阅涵盖所有内容，无需 Hostelworld 账户、会话管理或内部 API 密钥处理。

定价方案

采用按请求付费的阶梯定价模式。

• 免费额度: 每月前 100 次请求免费。
• 付费阶梯:
  • 第 101 至 10,000 次请求: 每次请求 0.002 美元
  • 第 10,001 至 100,000+ 次请求: 每次请求 0.001 美元

目标用户与用例

受众	用例
旅行应用	为 iOS、Android 或 Web 构建具有实时定价、照片和评分的旅舍搜索功能，无需网络爬虫。
数字游民平台	展示具有长住背景、免费取消标志和城市级统计信息的预算友好型住宿。
背包客应用	利用大洲 → 国家 → 城市层级结构和旅行者评论数据，为目的地发现提供支持。
价格聚合器	为比较和寻找优惠功能，从超过 36,000 家物业中提取实时宿舍和私人房间价格。
旅游运营商	将旅舍社交活动与旅游行程匹配，创建完全程序化的团体旅行体验。
研究人员	访问具有七类别评分和旅行者人口统计信息的结构化评论数据，用于酒店和旅游研究。

快速开始示例

健康检查（无需认证）

bash curl "https://hostelworld-api.p.rapidapi.com/health"

搜索巴塞罗那的旅舍（3 晚住宿）

bash curl "https://hostelworld-api.p.rapidapi.com/v1/cities/6/properties?dateStart=2027-06-01&numNights=3&guests=2&currency=USD" -H "X-RapidAPI-Key: YOUR_KEY" -H "X-RapidAPI-Host: hostelworld-api.p.rapidapi.com"

获取物业的近期评论

bash curl "https://hostelworld-api.p.rapidapi.com/v1/properties/105439/reviews?page=1&sort=-date" -H "X-RapidAPI-Key: YOUR_KEY" -H "X-RapidAPI-Host: hostelworld-api.p.rapidapi.com"

查找旅舍的即将举行的社交活动

bash curl "https://hostelworld-api.p.rapidapi.com/v1/properties/105439/events?startDate=2027-06-01&endDate=2027-06-30" -H "X-RapidAPI-Key: YOUR_KEY" -H "X-RapidAPI-Host: hostelworld-api.p.rapidapi.com"

端点类别

• Search: autocomplete, searchProperties
• Geography
• Properties
• Social
• Promotions
• Health: getHealth

附加说明

• 此 API 是 RapidAPI 上唯一可用的旅舍专用 API。
• 它解决了 Hostelworld.com 没有公共开发者 API 的问题，提供了一个干净、有文档记录的 REST 接口。
• 开发者无需构建和维护脆弱的网络爬虫，也无需处理上游会话、速率限制或针对 Hostelworld 内部系统的认证流程。