Hotel-X Development - Categories Query

Categories Query returns the list of categories for a given set of credentials (access). E.g. 5 stars, 1 key, etc.

1. How can I retrieve the Seller's Category List?

You just need to follow the specifications in our API Playground and build your own Categories Query, as easy as that! Also, remember you are able to personalize the fields requested, so only the information that matters to you is returned in the response.

Categories Query example:

{"query":"query ($criteria: HotelXCategoryQueryInput!, $relay: RelayInput!) {\n hotelX {\n categories(criteria: $criteria, relay: $relay) {\n edges {\n cursor\n node {\n code\n categoryData {\n code\n categoryCode\n texts {\n text\n language\n }\n }\n error {\n code\n type\n description\n }\n createdAt\n updatedAt\n }\n }\n }\n }\n}\n","variables":{"criteria":{"access":"","categoryCodes":[]},"relay":{}}}

2. What can I expect to receive in Categories Query response?

The fields returned are: 

  • Code
  • Category Code
  • Text

The amount of information and content returned might vary between Sellers.

3. Can I filter by categorycode?

Yes! You can filter your results by adding the "categoryCode" field to your criteria and specifying the category/s you want to receive.

2022-05-04_12h49_28

4. How should I map Hotel-X Categories? Does TravelgateX map for us?

Our objective is to ensure our Partners always receive the native information as sent by the Seller without any modification, so mapping should be done either internally or externally on your side.

Connecting with a new Seller doesn't always mean that you are interested in the whole portfolio of categories - maybe you are just interested in some specific category types (or maybe you don't even map Seller categories). Since mapping depends entirely on your side, you can map only those categories you are interested in.

More information on our API Playground