Hotel Finder API

The company that created the smart llm model for finding vacations currently allows you to connect to their API.
For service and support: [e-mail]
This API enables comprehensive hotel search and booking functionality with city-based searches, detailed hotel listings, and competitive pricing offers. It provides access to hotel images and complete property information to help users make informed booking decisions. Ideal for travel platforms and booking websites seeking reliable hotel...

原始信息汇总

Hotel Finder API 数据集概述

基本信息

• 数据集名称：Hotel Finder API
• 提供平台：RapidAPI
• 提供者：flyally
• 类别：Travel
• 当前版本：v1

定价方案

• BASIC：$0.00 / 月
• PRO：$4.00 / 月
• ULTRA：$9.00 / 月

核心功能

• 综合酒店搜索：通过名称或唯一标识符在全球范围内查找酒店。
• 丰富的媒体访问：检索高质量的酒店照片，包括封面图片和详细图库。
• 精确的地理定位：获取准确的GPS坐标、格式化地址和位置详情。
• 即用型地图：访问静态地图图像和可嵌入的交互式地图URL。
• 正确的归属：所有媒体均包含适当的署名和许可信息。
• 城市级发现：按城市搜索和探索酒店，并提供详细的位置元数据。
• 直接图像检索：使用酒店名称和坐标直接获取酒店图像。

主要用途

• 旅行预订网站和移动应用程序
• 酒店评论和比价平台
• 旅行博客内容自动化
• 物业管理系统
• 旅行行程构建器和规划工具
• 房地产和酒店营销平台

数据内容

• 酒店标识：唯一的酒店ID和名称
• 完整地址：包含GPS坐标的完整地址
• 封面图像：带标题的高质量封面照片
• 照片图库：按类别组织的图像
• 地图URL：静态和可嵌入的交互式地图
• 图像归属：正确的署名和来源许可信息

接口端点

1. Get Search Cities

   • 方法：GET
   • 功能：通过关键词搜索城市，以获取用于酒店搜索的城市代码和位置信息。
   • 查询参数：keyword (字符串，必需) - 城市名称或搜索词（例如 "Paris", "New York", "Tokyo"）。
   • 响应：返回匹配的城市及其代码、地理坐标和酒店搜索所需的位置元数据。

2. Get Hotel List

   • 方法：GET
   • 功能：使用城市代码检索特定城市中可用的酒店综合列表。
   • 查询参数：cityCode (字符串，必需) - 从城市搜索中获得的IATA城市代码（例如 "NYC", "PAR", "LON"）。
   • 响应：返回详细的酒店信息，包括酒店ID、名称、地址、坐标和指定城市的可用性指标。

3. Get Hotel Offer

   • 方法：GET
   • 功能：使用灵活的搜索参数获取详细的酒店报价、可用性和定价信息。
   • 路径参数：params (字符串，必需) - 包含搜索条件的URL编码查询字符串（例如 "hotelIds=HOTEL123&adults=2&checkInDate=2025-12-25"）。
   • 响应：返回包含定价、房间可用性、预订条件以及详细酒店信息（包括照片和位置数据）的综合酒店报价。

4. Get Hotel Images

   • 方法：POST

   • 功能：通过提供酒店名称和GPS坐标直接检索酒店图像。

   • 请求体示例： json { "hotel_name": "KARACHI MARRIOTT HOTEL", "latitude": 24.8463, "longitude": 67.03118 }

   • 参数：

     • hotel_name (字符串，必需) - 酒店的全名或部分名称
     • latitude (数字，必需) - 酒店位置的纬度坐标
     • longitude (数字，必需) - 酒店位置的经度坐标

   • 响应：为指定物业返回包含5个高质量酒店图像URL的数组。

快速开始步骤

1. 订阅API计划
2. 在请求头中使用您的RapidAPI密钥
3. 使用必需的参数发起GET请求
4. 解析JSON响应以显示酒店信息

重要注意事项

• 所有日期必须为YYYY-MM-DD格式
• 城市代码必须是有效的IATA代码，且从城市搜索端点获取
• 对搜索参数使用正确的URL编码
• 响应时间可能因查询复杂度而异
• 图像URL是临时的，应适当缓存
• 始终尊重图像署名和许可要求

支持与联系

• 服务与支持邮箱：[e-mail]