Hostelworld API

Unofficial Hostelworld data API: autocomplete locations, search hostels & budget hotels with live pricing & ratings, property details, reviews, availability, linkups/events, city review-summaries & districts.

原始信息汇总

数据集概述：Hostelworld API

这是一个非官方的 Hostelworld 数据集，提供与旅舍和廉价酒店相关的丰富数据，特别适合旅行应用、预算住宿聚合器和行程规划工具。

核心数据与功能

该数据集通过 8 个 API 端点提供以下数据：

• 位置自动补全：根据输入的部分名称，返回城市、地点或属性的 ID。
• 旅舍/酒店搜索：根据城市名称搜索旅舍及廉价酒店，包含实时价格和评分。
• 物业详情：获取具体物业的完整描述、设施、图片、地址、政策（入住/退房、免费取消）及最低价。
• 住客评价：提供按 7 个类别评分的评价数据，以及最新评价中的住客国籍、年龄段和性别信息。
• 价格与可用性：查询物业的可订状态、最低价格及免费取消信息。
• 社交活动：获取物业层面的社交聚会、旅游或活动（Linkups/Events）信息。
• 独有城市数据：
  • 城市评价摘要：提供城市级别的 9 个类别评分（如活动、夜生活、交通等）和近期评价。
  • 城市信息与区域：提供城市区域划分、各区域物业数量及起价、精选物业列表。

端点概述

方法	路径	描述
GET	/api/v1/autocomplete	解析位置名称并返回 ID
GET	/api/v1/search	根据城市名称搜索物业，含实时价格
GET	/api/v1/properties/{id}	获取物业的完整详情
GET	/api/v1/properties/{id}/reviews	获取住客评价及 7 类别评分
GET	/api/v1/properties/{id}/availability	获取物业可用性、最低价及免费取消信息
GET	/api/v1/properties/{id}/linkups	获取物业的社交活动信息
GET	/api/v1/cities/reviews-summary	获取城市级别评价摘要（9 类别），此为独有数据
GET	/api/v1/cities/info	获取城市信息、区域及顶级物业，此为独有数据

关键参数

参数	适用端点	类型	必需	说明
q	autocomplete	string	是	部分位置名称
query	search, cities/*	string	是	城市名称（如 Barcelona）
id	properties/*	string (路径)	是	物业数字 ID
dateStart	search, properties, availability	string	否	入住日期，格式 YYYY-MM-DD，默认约 30 天后
numNights	search, properties, availability	int (1-30)	否	入住天数，默认 3
guests	search, properties, availability	int (1-20)	否	住客人数，默认 2
currency	大多数	string	否	ISO 货币代码，默认 USD
page	search	int (1-50)	否	页码

响应数据亮点

• 搜索：返回包含评分、评价数、床位/房间最低价、7 类别评分、地理坐标、距市中心距离、标签、图片的 properties[] 数组，以及总数和总页数。
• 物业详情：包含描述、设施（特色及总数）、图片、地址与导航信息、政策、支付方式、最低价及评价摘要。
• 评价：提供 7 类别平均评分、总评价数及最新评价（含住客国家、年龄段、性别）。
• 城市评价摘要：提供 9 类别城市评分（活动、夜生活、交通等）及近期评价。
• 城市信息：提供各区域物业数量与起价，以及精心挑选的顶级物业列表。

注意事项

• 搜索查询 (/search, /cities/*) 建议使用单个城市名称（如 Barcelona）以获得最佳结果。若需消歧，可先调用 /autocomplete 获取准确城市名。
• 错误码：404（城市/物业未找到或无结果），422（参数缺失或无效），502（上游提取错误，可重试）。