POST
/hoteldemand/Get Hotel Demand
This API retrieves hotel demand data based on either an individual hotel or an entire city.
If a hotel is provided as input, demand is calculated for that single hotel.
If a city is provided as input, demand is calculated for all hotels in the city, returning an H × D matrix, where:
H = Number of hotels in the city
D = Number of days in the selected time range.
If a hotel is provided as input, demand is calculated for that single hotel.
If a city is provided as input, demand is calculated for all hotels in the city, returning an H × D matrix, where:
H = Number of hotels in the city
D = Number of days in the selected time range.
POST
/hoteldemand/Mandatory Fields
- hotelCode
- Or city and country
- startDate
- horizon
Note
Once the request is processed, the results will be emailed to the registered user.
Important Notes
Output Files:
- Absolute Demand - Estimated number of potential guests per day.
- Relative Demand - A value between 0-100, where 0 is the lowest demand and 100 is the highest.
- Events Registered - Number of events per day contributing to the demand.
- Event Records (City-Level Only) - Detailed event data including event name, venue, category, date, and expected attendance.
Search Criteria:
- Either hotelCode or city, country must be provided.
- horizon (days to retrieve data for) must be ≤ 365.
- category and subCategory can be a single number, range, or combination.
Parameter Details
| Name | In | Type | Required | Description |
|---|---|---|---|---|
body | body | Required | none |
Responses
| Status | Meaning | Description | Schema |
|---|---|---|---|
| 200 | OK | OK | |
| 400 | Bad Request | Bad Request | None |
| 401 | Unauthorized | Unauthorized | None |
| 429 | Too Many Requests | Too Many Requests | None |
| 500 | Internal Server Error | Internal Server Error | None |
Example Request
# You can also use wget
curl -X POST /hoteldemand/ \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer {access-token}'Body parameter
{
"hotelCode": 0,
"city": "",
"country": "",
"horizon": 30,
"startDate": "2025-05-06",
"estimatedAttendee": "",
"category": "0",
"subCategory": "0"
}Example responses
200 Response
{
"demandId": 612
}Example request
{
"hotelCode": 0,
"city": "Florida",
"country": "United States",
"horizon": 5,
"startDate": "2022-04-01",
"estimatedAttendee": ">1000",
"category": "2,4",
"subCategory": "1,5-7"
}Need Support?
Our team is here to help you integrate and make the most of our APIs. Get in touch for technical support, custom solutions, or any questions.