Tourmind AI APIs

AI Room Matching & Mapping

AI Room Map

The Room Map API aggregates and categorizes comparable rooms from various suppliers for a specific property. It processes room data and organizes rooms with similar attributes into unified groups.

If you do not have a self-maintained standardized room type list, the RoomMap API can be employed to derive a set of recommended standard room types based on historical data analysis, serving as an effective way for room type classification.

API Call Schema

Name	Value
Request URL	http://developers.tourmind.cn/v2/RoomMap
Request method	POST

Request Fields

PropertyId: string

Unique identifier for the hotel property

PropertyName: string

The name of the hotel property

SupplierId: string

Unique identifier for the supplier

RoomId: string

Unique identifier for the room

RoomName: string

Original room name provided by the supplier

Response Fields

GroupCode: string

A unique code representing the group of rooms.

GroupName: string

The name of the room group.

RoomIds: string

The unique identifier for the room.

RoomName: string

The name of the individual room within the group.

SupplierId: string

The identifier for the supplier providing the room.

PropertyId: string

A unique identifier for the property.

PropertyName: string

The name of the property (hotel) being referenced.

Unmapped[]: any

A list of unmapped rooms or groups, if any.

Body parameters

{
  "SupplierList": [
    {
      "SupplierRooms": [
        {}
      ]
    }
  ]
}

Responses

{
  "Aggregation": [
    {
      "GroupRooms": [
        {}
      ]
    }
  ],
  "Unmapped": []
}

AI Room Match

The Room Match API provides an intelligent room matching service that establishes relationships between reference hotel rooms and supplier room listings. By AI algorithm, it automatically matches standard room types from reference hotels with room information provided by different suppliers.

If you already maintained your own standardized room types, it is recommended to utilize the Room Match feature to directly leverage their curated data for accurate room type matching.

API Call Schema

Name	Value
Request URL	http://developers.tourmind.cn/v2/RoomMatch
Request method	POST

Request Fields

AppKey: string

EnableDeepThinking: boolean

BedName: string

RoomId: string

RoomName: string

PropertyId: string

PropertyName: string

AgentCode: string

Unique code for the agent provided by TourMind.

Password: string

Password for the API request.

RequestTime: string

Request timestamp in ISO 8601 format with millisecond precision, e.g., "2006-01-02T15:04:05.123Z".

TransactionID: string

Identifier for tracing API requests, such as using a GUID.

UserName: string

Username for the API request.

SupplierId: string

SupplierBedName: string

SupplierRoomId: string

SupplierRoomName: string

Response Fields

Code: integer

BedName: string

Score: number

SupplierBedName: string

SupplierId: string

SupplierRoomId: string

SupplierRoomName: string

RoomId: string

RoomName: string

PropertyId: string

PropertyName: string

ErrorCode: string

Error code.

ErrorCode	Description
101	No payload in the request.
102	Invalid format of the request.
103	Request data validation failed.
104	Service error.
105	API user authentication error; invalid AgentCode, Username, or Password.

ErrorMessage: string

Error message.

ResponseTime: string

Response timestamp, format: “2006-01-02 15:04:05”.

TransactionID: string

This value must match the TransactionID in the request..

Success: boolean

Score: number

SupplierBedName: string

SupplierId: string

SupplierRoomId: string

SupplierRoomName: string

Body parameters

{
  "MasterRoomList": [
    {}
  ],
  "PropertyInfo": {},
  "RequestHeader": {
    "AgentCode": "tms_test",
    "Password": "tms_test",
    "RequestTime": "2018-07-26T09:51:32.123Z",
    "TransactionID": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
    "UserName": "tms_test"
  },
  "SupplierRoomList": [
    {
      "SupplierRoomInfo": [
        {}
      ]
    }
  ]
}

Responses

{
  "Data": {
    "MatchedRooms": [
      {
        "MatchedRooms": [
          {}
        ]
      }
    ]
  },
  "Error": {
    "ErrorCode": "101",
    "ErrorMessage": "invaild param"
  },
  "ResponseHeader": {
    "ResponseTime": "2018-07-26 09:51:32",
    "TransactionID": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  },
  "UnmatchedRooms": [
    {}
  ]
}

AI Rate Prediction

AI Rate Prediction

The Price Prediction API provides a robust solution for forecasting future pricing trends for hotel room types. This API is designed to help users and businesses in the hospitality sector make informed decisions regarding pricing strategies by offering insights into expected low and high price ranges for various hotel room types over specified time periods.

API Call Schema

Name	Value
Request URL	http://developers.tourmind.cn/v2/RatePrediction
Request method	POST

Request Fields

CheckIn: string

Check-in date (ISO 8601 format)

CheckOut: string

Check-out date (ISO 8601 format)

CurrencyCode: string

Preferred currency code

City: string

Country: string

HotelName: string

Adults: integer

Children: integer

ChildrenAges[]: integer

RoomCount: integer

Response Fields

City: string

The city where the hotel is situated.

Country: string

The country where the hotel is located.

HotelName: string

The name of the hotel.

End: string

The end date of the low price period in ISO 8601 format.

Start: string

The start date of the low price period in ISO 8601 format.

CurrencyCode: string

The currency code for the prices (e.g., USD, EUR).

Max: number

The maximum price during the low price period.

Min: number

The minimum price during the low price period.

End: string

The end date of the low price period in ISO 8601 format.

Start: string

The start date of the low price period in ISO 8601 format.

CurrencyCode: string

The currency code for the prices (e.g., USD, EUR).

Max: number

The maximum price during the low price period.

Min: number

The minimum price during the low price period.

RoomName: string

The name of the room type.

Body parameters

{
  "Hotels": [
    {
      "City": "Shanghai",
      "Country": "China",
      "HotelName": "Hilton Shanghai"
    }
  ],
  "PaxRooms": [
    {
      "Adults": 2,
      "ChildrenAges": []
    }
  ]
}

Responses

{
  "PricePredictions": [
    {
      "HotelInfo": {},
      "RoomTypes": [
        {
          "HighPricePeriods": [
            {
              "DateRange": {},
              "HighPriceRange": {}
            }
          ],
          "LowPricePeriods": [
            {
              "DateRange": {},
              "LowPriceRange": {}
            }
          ]
        }
      ]
    }
  ]
}