价格查询

约 687 字大约 2 分钟

2026-03-27

POST 价格查询

此 API 用于根据指定的酒店 ID 列表获取酒店的低价信息。

支持返回实时价格及房价计划信息，包括每日价格、餐型、取消政策等。

接口地址

POST /rate/pricesearch?$format=json

请求参数说明

{
  "HotelIDList": [117274],
  "CheckInDate": "2026-04-15",
  "CheckOutDate": "2026-04-16",
  "LowestPriceOnly": false,
  "IsRealTime": {
    "RoomCount": 1,
    "Value": true
  },
  "RealTimeOccupancy": {
    "AdultCount": 2,
    "ChildCount": 0
  },
  "Currency": "USD",
  "Nationality": "CN"
}

属性	类型	必填	说明
HotelIDList	List	是	酒店ID列表
CheckInDate	String	是	入住日期
CheckOutDate	String	是	离店日期
LowestPriceOnly	boolean	是	是否只返回最低价
IsRealTime	number	是	实时查询
RealTimeOccupancy	number	是	实时入住
Currency	String	是	币种
Nationality	String	是	国籍

IsRealTime说明

属性	类型	必填	说明
RoomCount	number	是	房间数量（仅作为筛选条件）
Value	boolean	是	是否实时查询

RealTimeOccupancy说明

属性	类型	必填	说明
AdultCount	number	是	成人数
ChildCount	number	是	儿童数

请求示例

curl --location --request POST '{{domain}}/rate/pricesearch?$format=json' \
--header 'Authorization: PHT apikey={{api_key}},signature={{signature}},timestamp={{timestamp}}'  \
--header 'api_key: {{api_key}}' \
--header 'Content-Type: application/json' \
--data-raw '{
"HotelIDList": [117274],
"CheckInDate": "2026-04-15",
"CheckOutDate": "2026-04-16",
"LowestPriceOnly": false,
"IsRealTime": {
"RoomCount": 1,
"Value": true
},
"RealTimeOccupancy": {
"AdultCount": 2,
"ChildCount": 0
},
"Currency": "USD",
"Nationality": "CN"
}'

返回示例

{
  "Success": {
    "PriceDetails": {
      "CheckInDate": "2026-04-15 00:00:00",
      "CheckOutDate": "2026-04-16 00:00:00",
      "HotelList": [
        {
          "HotelID": 117274,
          "HotelName": "洲际酒店集团纽约巴克莱洲际酒店(InterContinental New York Barclay by IHG)",
          "Destination": { "CityCode": "178293" },
          "RatePlanList": [
            {
              "RoomOccupancy": {
                "RoomNum": 1,
                "AdultCount": 2,
                "ChildCount": 0
              },
              "RoomTypeID": 10200440,
              "RoomName": "1 King Classic",
              "RatePlanID": "-2413223621322697309",
              "RatePlanName": "CLASSIC KING",
              "BedType": 73,
              "Currency": "USD",
              "TotalPrice": 409,
              "PriceList": [
                {
                  "Price": 409,
                  "StayDate": "2026-04-15 00:00:00",
                  "MealType": 1,
                  "MealAmount": 0
                }
              ],
              "RatePlanCancellationPolicyList": [
                { "LocalFromDate ": "2026-03-24T23:00:00+07:00", "Amount": 409 }
              ]
            },
            ...
          ]
        }
      ]
    }
  }
}

返回参数说明

属性	类型	必填	说明
CheckInDate	DateTime	是	入住日期
CheckOutDate	DateTime	是	离店日期
HotelList	List	是	酒店列表

HotelList 对象说明

属性	类型	必填	说明
HotelID	number	是	酒店ID
HotelName	String	是	酒店名称
Destination	Object	否	目的地信息
RatePlanList	List	是	房价计划集合

Destination 说明

属性	类型	必填	说明
CityCode	String	否	城市编码

RatePlanList 说明（核心）

属性	类型	必填	说明
RatePlanList	List	是	房价计划集合
RoomTypeID	number	是	房型ID
RoomName	String	是	房型名称
RatePlanID	String	是	房价计划ID
RatePlanName	String	是	房价计划名称
BedType	number	否	床型ID
Currency	String	是	币种
TotalPrice	Decimal	是	总价（含税）
PriceList	List	是	每日价格
RatePlanCancellationPolicyList	List	否	取消政策

RoomOccupancy 说明

属性	类型	必填	说明
RoomNum	number	是	房间数量
AdultCount	number	是	成人数
ChildCount	number	是	儿童数

PriceList 说明

属性	类型	必填	说明
Price	Decimal	是	当日价格
StayDate	DateTime	是	日期
MealType	number	是	餐型
MealAmount	number	是	餐食份数

取消政策说明

属性	类型	必填	说明
LocalFromDate	String	否	酒店当地时间
Amount	Decimal	否	取消罚金