Поиск отелей#

Операция поиска отелей — основная точка входа для получения доступных отелей в регионе.

Описание#

Эндпоинт: POST /hotels/search

Возвращает список доступных отелей с минимальными ценами для заданного региона и дат. В ответе возвращается searchId, который используется в последующих операциях (получение цен, бронирование).

Использование#

Используйте этот запрос для поиска отелей по региону. Это первый шаг перед выбором конкретного отеля и бронированием.

Основной сценарий#

1. Отправьте запрос с регионом, датами и гостями
2. Получите список отелей с минимальными ценами
3. Выберите подходящий отель (hotelId)
4. Используйте searchId для получения детальных цен через /hotels/hotel_pricing

Базовый пример#

Минимальный запрос для поиска отелей:

1{
2  "regionId": "2671",
3  "checkin": "2025-12-15",
4  "checkout": "2025-12-18",
5  "currency": "RUB",
6  "guests": {
7    "adults": 2
8  }
9}

Ответ содержит:

1{
2  "totalHotels": 42,
3  "searchId": "search-abc123",
4  "hotels": [ /* список отелей с минимальными ценами */ ]
5}

Детальная документация#

• Параметры запроса — полное описание всех параметров и примеры использования
• Структура ответа — детальное описание структуры ответа

Типичные ошибки#

Связанные операции#

• Цены отеля — получение всех предложений для выбранного отеля
• Создание бронирования — бронирование выбранного номера