Singapore Hotels

Discover Singapore hotels with powerful search, filtering, and detailed insights.

原始信息汇总

Singapore Hotels API 数据集概述

数据集基本信息

• 数据集名称：Singapore Hotels API
• 数据集类别：Travel
• 提供商：CraftAPI
• 订阅者数量：12
• API版本：v1 (current)

订阅计划与定价

• BASIC：$0.00 / 月
• PRO：$0.99 / 月
• ULTRA：$4.99 / 月
• MEGA：$14.99 / 月

数据集描述

该API提供了一个可靠且开发者友好的方式来搜索、筛选和检索新加坡各地酒店的信息。它专为旅行社、预订平台、酒店业初创公司、旅游局和数据驱动型应用程序设计，提供准确且结构化的酒店数据，可轻松集成到您的系统中。

目标用户/行业

• 旅游科技初创公司和平台
• 酒店预订和元搜索引擎
• 旅游网站
• 房地产和搬迁服务
• 数据分析师和酒店业研究人员

主要特性与优势

• 全面的酒店记录：每个酒店都有唯一标识，包含全名、地址、邮政编码、总房间数、联系邮箱和地理坐标。
• 灵活、强大的搜索：按酒店名称、地址（部分或完整）或邮政编码进行查询——甚至支持部分匹配。
• 高级列表API：分页、多字段排序和基于字段的筛选（支持比较运算符）。
• 丰富的详细信息：通过UUID获取完整的酒店信息。
• 快速、开发者友好：简单的RESTful端点、描述性错误和高性能查询。
• 可扩展的集成：非常适合B2C预订流程、商业仪表板或数据集的丰富化。

典型用例

• 构建按位置、名称或邮政编码提供酒店发现的旅行应用程序。
• 将实时酒店数据集成到礼宾机器人或物业列表平台中。
• 为商业智能或研究分析酒店业趋势。

API端点

• GET /hotels
• GET /hotels/{id}
• GET /hotels/search/name
• GET /hotels/search/postal
• GET /hotels/search/address

快速入门

1. 获取API密钥

• 通过RapidAPI订阅API并获取唯一的API密钥。

2. 发出第一个请求

获取新加坡酒店的第一页，每页20个结果：

• 端点：GET https://{base_url}/api/v1/hotels?page=0&size=20
• 请求头：
  • X-RapidAPI-Key: YOUR_API_KEY
  • Accept: application/json

搜索功能

• 按酒店名称搜索：GET /api/v1/hotels/search/name?value=Marina
• 按地址搜索：GET /api/v1/hotels/search/address?value=Orchard
• 按邮政编码搜索：GET /api/v1/hotels/search/postal?value=238879

示例用例

1. 酒店预订应用程序搜索：显示与旅行者部分搜索匹配的酒店。
2. 丰富房地产列表：将酒店邻近度或详细信息嵌入房地产或搬迁平台以增加价值。
3. 礼宾和聊天机器人集成：为对话助手提供实时酒店详情，并按名称或邮政编码搜索以提供个性化推荐。
4. 市场/竞争对手分析：使用API获取酒店容量、位置和详情的更新列表，用于竞争格局研究。

数据字段示例

酒店记录包含以下字段：

• id (UUID)
• name
• address
• postalCode
• totalRooms

分页、排序与筛选

• 分页：从零开始（第一页为page=0）。最大允许页数为500，每页最大size为20。
• 筛选：使用参数格式filter[fieldName][operator]=value。支持的运算符包括eq、gte、lte、gt、lt。筛选和排序的字段名和值区分大小写。
• 排序：使用sort参数。-前缀表示降序。多字段示例：sort=-totalRooms,name。

错误处理

• 无效参数或字段：返回400状态码及描述性错误信息。
• 酒店未找到：返回404状态码及错误信息。
• 无效UUID格式：返回400状态码及错误信息。

常见问题解答

• 是否需要API密钥？：是。必须通过RapidAPI订阅，并在每个请求中使用X-RapidAPI-Key请求头包含您的API密钥。
• 按地址或名称搜索是否区分大小写？：否。/search/name和/search/address端点不区分大小写，并允许部分匹配。
• 此API是否提供实时酒店房间可用性或预订信息？：否。此API提供静态酒店列表数据（包括房间数量），但不提供实时可用性或价格。
• API返回什么响应格式？：所有响应均为JSON格式。
• 如何报告错误或请求支持？：使用RapidAPI门户联系我们。