HotelSignals

Turn raw hotel and hostel data into filterable lifestyle signals (social_score, solo_friendly, party_level, vibe). Built as a post-processing add-on for travel APIs.

原始信息汇总

HotelSignals API 数据集概述

数据集基本信息

• 数据集名称：HotelSignals
• 类别：Travel
• 提供者：ADC Studio
• 订阅者数量：1

数据集描述

HotelSignals 是一个用于旅行数据的增强 API。它分析酒店、青年旅舍、露营地或活动项目的有效负载，并返回关于氛围、受众和适用性的结构化洞察。该 API 不替代您现有的旅行数据提供商，而是在其之后接入。您发送已有的数据（名称、描述、评论、设施），HotelSignals 将其转化为您的应用程序可以立即使用的可操作信号。

核心功能

• 结构化氛围信号：social_score, party_level, quiet_level, solo_friendly, digital_nomad_friendly
• 受众画像：旅行者类型（独自旅行者、背包客、数字游民），可检测时的年龄范围
• 活动检测：冲浪、瑜伽、联合办公、健身、潜水、徒步等
• 基于置信度的输出：根据输入质量提供高或低置信度结果
• 无状态且安全：无持久化存储，无爬取，无法律风险

典型用例

• 旅行和预订应用程序
• 青年旅舍发现平台
• 青年和背包客旅行应用程序
• 基于冲浪、健身或活动的旅行产品
• 酒店 API 之上的推荐和过滤层

API 端点

• POST /v1/analyze/place：分析单个地点并返回结构化信号
• GET /v1/meta：返回 API 配置信息
• GET /v1/status：返回 API 健康状态

请求格式

必需字段

• place.name：地点名称（字符串）
• place.location.city 或 place.location.address：至少一个位置标识符

推荐字段

• place.description：地点描述文本
• place.reviews：包含文本内容的评论对象数组
• place.amenities：设施字符串数组

有效负载限制

• 最大有效负载大小：100 KB
• 每个请求最大评论数：50

响应格式

成功响应结构

包含 status, processed_at, insights_version, source, place, analysis 等字段。analysis 中包含 confidence, tags, signals, audience, activities 等。

信号说明

• social_score：数字 0-10，氛围社交程度
• solo_friendly：布尔值，是否适合独自旅行者
• party_level：数字 0-10，派对强度
• quiet_level：数字 0-10，安静程度
• sport_intensity：数字 0-10，体育和体育活动关注度
• digital_nomad_friendly：布尔值，是否适合远程工作者（实验性信号）

置信度级别

• high：提供描述 + 2 条或更多评论，信号可靠
• medium：提供描述或部分设施，部分信号
• low：仅提供名称和位置，分析非常有限

定价与限制

订阅计划

• Basic：$0.00 / 月，100 次请求
• Pro：$5.00 / 月，5,000 次请求，超额 $0.0015/次
• Ultra：$25.00 / 月，30,000 次请求，超额 $0.001/次
• Mega：$99.00 / 月，300,000 次请求，超额 $0.0005/次

认证

使用 RapidAPI 进行认证。每个请求必须包含：

• X-RapidAPI-Key: your_api_key
• X-RapidAPI-Host: hotelsignals.p.rapidapi.com

支持的数据类型

• 支持的类型：hostel, hotel, camp, activity, restaurant
• 支持的活动：surf, yoga, fitness, boxing, coworking, diving, hiking, climbing

错误处理

错误代码

• MISSING_REQUIRED_FIELDS：缺少 place.name
• PAYLOAD_TOO_LARGE：请求超过 100 KB
• INTERNAL_ERROR：服务器错误（稍后重试）

重要说明

• 该 API 不是酒店搜索引擎、预订或定价 API、数据源或爬虫。
• 不支持实时数据，信号基于您发送的内容，而非实时评论。
• 输入接受任何语言，但分析对英文文本效果最佳。输出始终为英文（v1）。
• API 是幂等的，相同的请求返回相同的响应，无副作用，不存储状态。