1. Help Center Home
  2. Buying on TravelgateX
  3. Hotel-X Development/Booking Flow: Search

Hotel-X Development - Search Query

All about Hotel-X Search Query

Search is the first method in our Booking Flow. Search Query aims to return all the available options for a given date and itinerary (and for one or more Seller's accesses). You will find more information and examples in our Documentation.

Can I apply any filters to my Search request?💡

Of course! You have the option to apply the following filters to your Search Query:

  1. Rate Rules: You can specify the rate rules (such as package or honeymoon) to be included or excluded from the response.
  2. Status: You can specify whether you want to include or exclude OK and/or RQ status in Search response.
  3. Access: You can choose the Hotel-X acces codes to be included or excluded from your request. Please note that you can filter your Search by Hotel-X access code, or don't set any access at all. If you don't specify any accesses in your request, our system will request all the accesses available on your side, so please make sure you use your own context code in order to avoid mapping errors.

Feel free to check this article for further information on How to filter Search requests.✔️

Remember to upload your mapping files to our FTP in those cases you run requests with your own context codes - you will receive results from all your Sellers with your own hotel codes. You will find more information about Mapping on TravelgateX here.

Can I search by destination?🔎

Of course! You will find more information about our Search by Destination plugin here.

What are the minimum recommended fields to be added to a Search Query?✔️

Since the amount of information requested in Hotel-X Search Query will depend on your needs and preferences, our recommendation is to check all the the fields available in our Playground. For instance:

How many hotel codes per request can I request in Search?🔢

We recommend a maximum of 200 hotels: the new aggregator will split them in batches in order to request all of them to each Seller.

Please take note the current formula and rate limit are subject to change.

Are there any limitations on the number of searches/minute?❓

Not from TravelgateX side - we don't have any limitations on the RPM in any of our methods. However, some Sellers may have some limitations so we suggest you contact directly with them in order to discuss this information.

Does nationality or market affect the price returned?🌍

Yes, nationality and market might affect the rates received in Search response. This depends on the Seller so if you consider that you should get (or not) different rates depending on the nationality or market, please contact them directly.

Why there are so many fields with null value in the Search response?❎

The number of "null" values returned is determined by the information provided by Sellers. For example, if you include certain fields in your Search Query but the Seller does not have that information available on their side, the value will be returned in our response as "null".

For example, if following data has been declared in your Search Query, it is possible that a Seller may return:

... 
rooms {
          occupancyRefId
          code
          description
          refundable
          units
          roomPrice {
            price {
              currency
              binding
              net
              gross
              exchange {
                currency
                rate
              }
              markups {
                channel
                currency
                binding
                net
                gross
                exchange {
                  currency
                  rate
                }
              }
            }
beds {
            type
            description
            count
            shared
          }
...

For this request, the Seller may return the occupancyRefId, room description, refundable information and price but not the beds description (if that information is not available on their side, it would be returned as "null" in TravelgateX response).

Can we define our own context for 2 or more Suppliers?🚀

Certainly! You have the option to create your own Context. To do this, simply follow the instructions in our Documentation and upload the mapping files accordingly in order to use it in your requests. For more detailed information, please refer to our Documentation on Mapping.

How can we differentiate a child from an infant? What is the age range of each of them?👶

The age range for children and infants may vary depending on the Seller's restrictions. To find out the specific age range restrictions for each of your Sellers, you can refer to our Metadata Method or directly contact the Seller.

Can I receive a specific rate in Search response?🔎

If you want to receive a specific rate in the Search response, you have the option to filter the response by using the tag "rateRules". This allows you to customize the results and get the rates that meet your specific requirements.

Can I receive daily prices in Search response?📅

Yes, if the Seller provides the information, you can receive daily prices in Search response through the roomPrice>breakdown:

Can I filter the Hotel-X Search results by payment type?❓

Unfortunately, Hotel-X API does not currently offer the capability to filter search results by payment type. 

What is the lifespan of the Search id?🕗

Search ids do not expire, however, we strongly recommend to transition from Search to Quote as quickly as possible. This will ensure a smoother and more efficient booking process.