一、接口基础说明

item_get_app 是携程用于‌获取酒店详情原数据‌的专用API接口，可返回酒店全量原始信息，是对接携程酒店数据的核心接口之一。

二、公共请求参数

调用该接口需传入以下必填公共参数：

表格

名称类型必须描述

key String 是调用密钥，需在携程开放平台申请获取

secret String 是接口调用专属密钥

api_name String 是固定填写为 item_get_app

num_iid String 是目标酒店的唯一ID，可通过酒店搜索接口提前获取

非必填参数还支持自定义返回格式、语言、缓存策略等配置。

三、调用方式与示例

请求地址‌：标准格式为 https://api-gw.cn/xiecheng/item_get_app

Python调用示例‌：

python

import requests

url = "https://api-gw.cn/xiecheng/item_get_app"

params = {

"key": "你的申请的API Key",

"secret": "你的申请的Secret",

"api_name": "item_get_app",

"num_iid": "目标酒店ID"

}

response = requests.post(url, json=params)

data = response.json()

print(data)

调用成功后，接口会返回包含酒店名称、地址、房型、价格、设施、用户评分等全量原始详情数据。

四、注意事项

接口有调用频率限制，通常为每秒最多5次请求，建议用Redis缓存重复请求的酒店数据，避免触发限流。

需严格遵守携程开放平台的数据使用条款，禁止违规存储、泄露用户敏感信息。

调用前需先在携程开放平台完成开发者账号注册、应用创建和接口权限审核，获取合法的Key和Secret后才可正常调用。

需要我为你提供该接口的完整可运行Python代码示例，帮你快速调试对接吗？

ITPub博客

携程酒店详情信息一键获取，item_get_appAPI接口讲解