API отелей

Поиск отелей, тарифы и бронирование

Определите направление, выведите список объектов, проверьте тариф и подтвердите. Единый REST-поток, цены в USD.

Справочник APIЧитать гайд
POST /v2/Hotel/HotelAvailability
{
  "CheckIn": "2026-11-14",
  "CheckOut": "2026-11-16",
  "CityId": 11111111456928,
  "Occupancies": [ { "AdultCount": 2 } ],
  "Sort": "price"
}
Обзор

Гостиничный инвентарь огромен, а тарифы меняются быстро. Этот API размещения даёт публичный поиск мест, доступность в режиме города и отеля, проверку тарифа с окном удержания и понятный поток: сначала бронь, потом подтверждение.

Единый API размещения стоит перед миллионами объектов, от глобальных сетей до независимых бутиков. Доступность, типы питания, правила отмены и налоги приходят в одном формате и валюте, поэтому вашему сайту или приложению для бронирования отелей не нужно сводить десяток форматов поставщиков.

Что вы получаете

1

Публичный поиск мест подключается прямо к полю автодополнения.

2

Один эндпоинт доступности выводит целый город или открывает отдельный отель с его номерами.

3

Проверьте тариф, удержите номер, затем подтвердите и спишите, всё в USD.

4

Поиск по городу и по отелю из одного эндпоинта, от целого направления до отдельного объекта.

5

Проверка тарифа открывает короткое окно удержания, чтобы показанная цена была ценой брони.

Как устроен процесс

01

Resolve

Turn a destination string into a place id with public place search.

02

Search

List availability for a whole city, or open a single property with its rooms.

03

Validate

Confirm the live rate and open a short hold window.

04

Book

Place the order and confirm; your balance is charged on confirmation.

Ключевые эндпоинты

GET/Hotel/PlaceSearchResolve a destination into a place id.
POST/v2/Hotel/HotelAvailabilityList availability in city or hotel mode.
POST/Hotel/RateValidateValidate the selected rate and hold it.
POST/Hotel/HotelBookCreate and confirm the booking.
GET/Hotel/BookingDetailsRetrieve a booking and its status.

Запрос и ответ

Request · POST /v2/Hotel/HotelAvailability
{
  "CheckIn": "2026-11-14",
  "CheckOut": "2026-11-16",
  "CityId": 11111111456928,
  "Occupancies": [ { "AdultCount": 2 } ],
  "Sort": "price"
}
Response · 200 OK
{
  "hotels": [
    {
      "hotelId": "HTL-9931",
      "name": "Marina Suites",
      "stars": 4,
      "lowestRate": {
        "amount": 180.00, "currency": "USD", "board": "BB"
      },
      "rooms": [ { "code": "DLX-K", "refundable": true } ]
    }
  ]
}

Что содержит ответ

hotelId
Stable id for the property.
lowestRate
Cheapest bookable rate, in USD, with board type.
rooms
Room options with codes and refundability.
cancellationPolicy
Deadlines and penalties that apply to the rate.
hold
Minutes the validated rate stays bookable.
5 млн+

Отелей по всему миру

Частые вопросы

Как превратить направление в поиск?

Вызовите публичный поиск мест, чтобы превратить текст в id, и передайте этот id в доступность.

Сколько действует проверенный тариф?

Пятнадцать минут. Бронируйте в этом окне с возвращённым тарифным кодом.

Когда списывается баланс?

Только при подтверждении заказа. Бронирование удерживает номер без списания.

Включают ли тарифы налоги и сборы?

Да. Каждый тариф несёт валюту, тип питания и разбивку налогов и сборов, всё нормализовано в USD.

Можно ли открыть отдельный объект напрямую?

Да. Режим отеля открывает один объект с его номерами, а режим города перечисляет целое направление.

Продолжайте изучать

API авиабилетов

Поиск и бронирование авиабилетов от начала до конца

API активностей

Туры, достопримечательности и впечатления

Справочник API

Один запрос для старта

Соберите свой тревел-продукт на одном API.

Интеграция бесплатна. 1% за выписанный билет, не более $10. Живое покрытие авиабилетов, отелей и активностей.

Читать документациюСвязаться с отделом продаж