Token-based Pagination
What Is a Token (ContinuationToken)?
The token, also known as the ContinuationToken in the Hotel Buyers API (Legacy), plays a crucial role in downloading large lists of objects. It helps break down content into smaller segments, effectively preventing potential timeout errors.
Which Queries Support Pagination?
Pagination is available for the following queries:
- Hotels
- Destinations
- Rooms
What Is the Expiration Time for the Token (ContinuationToken)?
The token has an expiration time of 4 minutes, but each time a page request is made, the timer resets. This means the total time allowed depends on the size of the list and the frequency of requests.
Token-Based Pagination Guide for Hotel-X Pull Buyers API
To paginate content effectively, follow these steps:
-
Include the token in your request
Add the"token"
object to the fields and arguments in your query. You can also control the number of objects returned per page by using the"maxSize"
tag. -
Request subsequent pages
Once you receive a response, only a portion of the total list will be returned. To get the next page, copy the"token"
value from the response and include it in your next request. -
Repeat until completion
Continue requesting pages until the"token"
field is no longer included in the response.
The "maxSize"
value must be between 1 and 10,000 for Hotels, Rooms, and Destinations queries.
{
"criteria": {
"access": "",
"maxSize": 100
},
"language": "en",
"token": ""
}
A Quick Guide for Users of Legacy Pull Buyers API
Follow these steps to paginate content using the Legacy API:
-
Add the ContinuationToken tag to your request
You can specify the maximum number of objects per page using the"expectedRange"
attribute.<ContinuationToken expectedRange="1000"></ContinuationToken>
-
Request subsequent pages
After receiving a response, copy theContinuationToken
tag from the response and paste it into the next request to retrieve additional content. -
Repeat until completion
Continue this process until theContinuationToken
is no longer present in the response. If you encounter a 11204 error, it indicates that the entire list has been retrieved.
Additional Considerations
- Sometimes, the number of hotels returned may exceed the
expectedRange
value. For example, if set to1000
, the response may include anywhere from 1000 to 1999 hotels. - If the
expectedRange
attribute is not specified, the default maximum number of hotels in the list is 250,000. - When using
expectedRange
, select values that are multiples of 1,000 (e.g., 1000, 2000, 3000) for efficient data retrieval.