2.2.1.3 Get All Hotels Under Supplier Country Code
About 344 wordsAbout 1 min
2025-11-03
Warning
- Mandatory
- Klook uses this interface to retrieve the list of all hotel IDs under a specific country code from the supplier.
- The maximum number of calls for the same country code is 1000 times.
- Klook will iterate calls based on the
Supported country codes for static datain2.2.1.5 Offline Provision and Fixed Configuration Data Description
URL
Integrator to define and provide to Klook
Input Parameters
| Field | Type | Mandatory | Description |
|---|---|---|---|
countryCode | String | false | Standard two-letter country code 1：Please refer to 3.4 Basic Data Description2：If the number of hotels is not large and the access party and the klook side negotiate that it is not necessary to pull based on the countryCode, then the country code is empty |
requestToken | String | false | Supplier defined request token parameter, 1: Used for pagination2: Pass empty for the first request, maximum length 128 |
Base Input Parameter Extension Fields
| Field | Type | Mandatory | Description |
|---|---|---|---|
supplierAccount | String | false | openApi supplier account Integrator defines the account data1: The account is used for different product types for specific use cases. For example, a Member account returns rates for Members only, non-Members will not see the rate. It supports multiple accounts2: If the integrator does not have multiple accounts, the value passed is null3: Length does not exceed 128 characters |
Input Parameter Example
Example
{
"base": {
"requestId": "xxxx",
"requestTime": "xxx",
"requestAgent": "xxx",
"openApiSign": "xx",
"supplierAccount": "accountXX",
"version": "xxx"
},
"requestData": {
"countryCode": "HK",
"requestToken": "{\"nextPageSize\":10,\"lastRecordId\": xxx}"
}
}Output Parameters
| Field | Type | Mandatory | Description |
|---|---|---|---|
hotelIdList | List<String> | true | Integrator Hotel ID list |
nextRequestToken | String | false | Token required for the next request1: Used for pagination; returns empty if there is no next request |
Output Parameter Example
{
"success": true,
"error": {
"code": "",
"message": ""
},
"result": {
"hotelIdList": [
"10001",
"10002"
],
"nextRequestToken": "{\"nextPageSize\":11,\"lastRecordId\": xxx}"
}
}