Getting started with Hotel-X Buyers API
      Back to home
      1. Help Center Home
      2. Buying on TravelgateX
      3. Getting started with Hotel-X Buyers API

      Resources and Best Practices

      Read on for resources, tips and best practices that will help you make the most of your connection

      Main Resources🏆

      Hotel-X endpoint🌍

      To access all the methods available through our Hotel-X API, please use the endpoint "https://api.travelgatex.com" (both test and production environments).

      China endpoint: If your servers are located in China, you can improve performance by using the following URL: "https://api-cn.travelgatex.com".

      GZIP Compression📦

      To enhance performance and reduce bandwidth usage, it is mandatory to enable GZIP compression in the HTTP header for all Live traffic.

      Keep Alive Header🔎

      To boost performance and enhance response times in Search, you have the option to include the Connection: keep-alive header in all our transactions.

      GraphQL To REST🔋

      In case you expect receiving more than 5,000 options in each search response, we recommend utilizing our GraphQL to REST feature to maintain optimal performance.
      To implement this feature, please follow the steps below:
      1. Ensure that your JSON parser is updated to the latest schema as the Array. Fields previously defined as single Scalars may result in unexpected JSON marshalling.
      2. Include the HTTP header in your request(s): TGX-Content-Type:graphqlx/json
      3. Test a sample call for each request using the header.
      4. Enjoy the performance

      Improve GraphQL Performance🏅

      Feel free to visit our blog for tips on improving GraphQL performance when dealing with responses that have over 10,000 nodes or weigh more than 1Mb

      TravelgateX Status✅

      Stay informed about the real-time performance of our services with our Status page. Our event tracker and reliable metrics allow you to effortlessly track and monitor our performance.

      TravelgateX Plugins🔨

      Hotel-X provides customizable Plugins that enable you to integrate your own business logic seamlessly, without the need for separate implementation. With Hotel-X Plugins, you have full control over customizing your requests and responses to align with your specific requirements and easily enhance your functionalities as your business grows and evolves.

      In order to configure a Plugin, you'll need to upload a specific set of files to our FTP. Don't have your FTP credentials yet? No worries! Just raise contact our Support Team via "Tickets" and we will be happy to help you!

       

      Content Calls🏨

      The Hotel List, Room List, Board List, and other static information of Sellers can be obtained by making Content Calls through our API. It is highly recommended to implement these calls because sometimes the Seller codes may vary from the ones provided through TravelgateX API.

      Criteria Search🔎

      We strongly recommend including the following fields in the criteria section of your Hotel-X Search query:
      • Check-in
      • Check-out
      • Hotels
      • Occupancies
      • Language
      • Currency
      • Nationality
      • Market
      Please keep in mind the following points:
      • If you do not specify a currency, the default one will be applied.  However, it's important to note that even if you specify a specific currency, Sellers may still return rates in a different one.
      • Sellers might offer different rates depending on the market. 

      Hotel-X Calendar View📅

      You may build a calendar on your side with the Search response received via Hotel-X API, however, please note that the more requests you send to TravelgateX, the higher your bill may be due to having a huge L2B (this depends on the contract signed with TravelgateX).

      Book Status

      Learn all about Book (reservation) status here.

      Cancel Status

      Learn all about Cancel (cancellation) status here.

      Other Tools and Resources