# Content API

To understand the significance of the Content API, it's important to know that the data returned by the Travellerschoice Hotel API falls into two categories:

* **Static information**: This includes data not directly related to the booking process, such as comments, descriptions, hotel images, and addresses.
* **Dynamic information**: This refers to data that can change frequently, like prices, availability dates, cancellation policies, and fees.

The core idea behind the TCTT Hotel API is to provide results in a straightforward format as quickly as possible. To ensure this, we limit the size of response messages by returning only the dynamic booking-related information. However, static information is still valuable.

The ContentAPI is designed to deliver all the necessary static information for the BookingAPI in a fast and simple manner, offering quicker and more reliable access.

{% hint style="success" %}
In a nutshell, Content APIs provide all the static data in advance, ensuring that Booking APIs remain lightweight and perform faster. You are required to import all the static data (data masters) into your database. Booking APIs will reference these data masters using IDs, which you can use to retrieve and populate the necessary data when making a Booking API request.
{% endhint %}

{% hint style="info" %}
**How to manage contents:** The ContentAPI is designed to provide detailed information about the hotels available in our BookingAPI. It includes several methods that allow you to retrieve hotel details, as well as lists of destinations, countries, and master data that enrich hotel information (such as room type descriptions, accommodation type descriptions, and category descriptions).
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://apidocs.mytravellerschoice.com/hotel-content-api/content-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
