HolidayCheck Reviews & Hotel Insights
收藏官方服务：
资源简介：
Collect hotel reviews, ratings, owner responses, and aspect scores from HolidayCheck as structured JSON. Built for hospitality analytics and reputation monitoring. Independent service, not affiliated with HolidayCheck.
创建时间：
2026-09-09
原始信息汇总
HolidayCheck Reviews & Hotel Insights 数据集概述
基本信息
- 数据集名称：HolidayCheck Reviews & Hotel Insights
- 数据集地址：https://rapidapi.com/kamerozkan/api/holidaycheck-reviews-hotel-insights
- 分类：Travel（旅游）
- API 创建者：Kamer Ozkan
- 订阅者数量：1
- 版本：v1（当前版本）
- 独立性声明：由 Kamer Ozkan 独立运营，与 HolidayCheck 无关联、未获其认可，非 HolidayCheck 官方 API
数据集内容
该 API 用于将 HolidayCheck 酒店页面转换为结构化 JSON 数据，主要包括：
- 宾客评论：评论文本、标题、日期、推荐意见，以及按 HolidayCheck 1-10 分制标准化的评分
- 酒店业主回复：公开可用的业主回复内容
- 维度评分（Aspect Scores）：基于来源评分与主题字段推导，包含任务内的月度趋势
- 可比酒店候选（可选）：最多 5 家可比酒店
- JSON 管理报告（可选）
核心功能与接口
端点
| 方法 | 端点 | 功能 |
|---|---|---|
| POST | startReviewCollection | 启动评论采集任务 |
| GET | getReviewJobStatus | 查询任务状态 |
| GET | getReviewJobResults | 获取任务结果 |
使用流程
- 使用一个酒店 URL 启动采集任务，成功返回 HTTP 202，包含
jobId、statusPath、resultsPath、expiresAt - 轮询任务状态（间隔至少 15 秒），
ready为true时获取结果 - 检索完成的 JSON 结果
结果字段
count：返回的评论行数reviews：结构化评论记录trends：基于当前任务计算出的维度趋势competitors：可比酒店候选（如请求）report：JSON 管理报告（如请求）coverage：采集覆盖面与健康度
输入参数与限制
| 参数 | 默认值 | 支持值 |
|---|---|---|
hotelUrl |
必填 | 一个包含酒店 ID 的 HTTPS holidaycheck.de 酒店 URL |
maxReviews |
20 | 1 至 100 的整数 |
sort |
entrydate | entrydate、ranking、positive、negative |
includeCompetitors |
false | 最多 5 家可比酒店 |
includeReport |
false | 是否包含管理报告 |
reportLanguage |
en | en 或 de（仅报告标签） |
其他限制：
- 每个任务仅处理一家酒店，最长运行 5 分钟
- 每位订阅者每分钟最多启动 2 个任务，每分钟最多 30 次状态/结果请求
- 请求体限制为 8 KB
- 任务访问在创建后 24 小时过期，且仅限启动该任务的订阅者访问
请求计费方式
- 计费单位为 HTTP 请求数，而非评论数量
- 启动任务、轮询状态、获取结果、调用健康端点均消耗计划请求额度
- 示例：1 次启动 + 2 次状态查询 + 1 次结果获取 = 4 次请求
- 最大评论数是限制上限，并非可用结果的保证
覆盖范围与说明
- 评论文本保留原始语言
- 不执行 AI 情感分析或翻译
- 维度评分为基于来源评分/主题字段的确定性信号
- 趋势与报告仅覆盖当前任务采集的评论，非完整酒店历史
- 可比酒店候选不含实时预订价格
- 评论者个人资料详情已禁用
- 来源变更、评论删除、访问限制可能影响覆盖范围
未包含的功能
- AI 增强
- 翻译
- 实时价格比较
- 自定义 Webhook
- 跨任务检查点（cross-run checkpointing）
可供选择的订阅计划
| 计划 | 价格 |
|---|---|
| BASIC | $0.00 / 月 |
| PRO | $19.00 / 月 |
| ULTRA | $59.00 / 月 |
| MEGA | $149.00 / 月 |
错误代码说明
| 状态码 | 含义 |
|---|---|
| 400 / 415 | 检查输入字段与 JSON 内容类型 |
| 403 | 检查 RapidAPI 订阅与认证 |
| 404 | 任务无效、已过期或属于其他订阅者 |
| 413 | 减小请求体大小 |
| 422 | 采集失败 |
| 429 | 遵守重试延迟与计划配额 |
| 502 / 503 | 服务或来源暂时不可用 |
性能指标
- 受欢迎程度：8.6
- 服务等级：100%
- 延迟：937ms
- 测试：N/A
支持渠道
- 通过 RapidAPI 消息或讨论区
- 反馈时需包含：端点、时间、HTTP 状态码、任务 ID（如有）
- 严禁发送 API 密钥或其他凭证
