Получение информации об отеле по идентификатору

Возвращает детальную информацию об отеле по идентификатору отеля, за исключением сущностей, для которых нужен paging или polling.

Формат запроса

GET https://whitelabel.travel.yandex-net.ru/hotels/hotel/
  ? hotel_id=<string>
  & [affiliate_clid=<string>]

Authorization: OAuth <OAuth token>
Content-Type: application/JSON

Параметры запроса

Параметр

Описание

hotel_id*

Идентификатор отеля.

affiliate_clid

Идентификатор, выданный партнеру сервисом Яндекс Дистрибуция, к которому относится запрос. При отсутствии параметра будет использован clid, установленный партнеру при регистрации в системе.

* Обязательный параметр

Пример запроса

https://whitelabel.travel.yandex-net.ru/hotels/hotel/?hotel_id=1019057204

Формат ответа

{
  "hotel_id": "(string)",
  "name": "(string)",
  "location": {
    "country_name": "(string)",
    "settlement": {
      "type": "(string)",
      "name": "(string)"
    },
    "address": "(string)",
    "lon": (double),
    "lat": (double),
  },
  "stars": (integer),
  "check_in": {
    "from": "(string)",
    "until": "(string)"
  },
  "check_out": {
    "from": "(string)",
    "until": "(string)"
  },
  "total_review_count": (integer),
  "total_image_count": (integer),
  "ratings": {
    "rating": "(string)",
    "teaser": "(string)",
    "feature_ratings": [
      {
        "name": "(string)",
        "positive_percent": (integer)
      },
    ]
  },
  "location_features": [
    {
      "type": "(string)",
      "name": "(string)",
      "coordinates": {
        "lon": (double),
        "lat": (double)
      },
      "distance_meters": (integer),
      "metro_line": {
        "name": "(string)",
        "color": "(string)",
      }
    },
  ],
  "amenities": {
    "groups": [
      {
        "name": "(string)",
        "amenities": [
          {
            "id": "(string)",
            "name": "(string)",
            "is_important": (boolean)
          },
        ]
      },
    ]
  },
}

Параметры ответа

Параметр

Тип

Описание

hotel_id

string

Идентификатор отеля.

name

string

Название отеля.

location

object

Географическое расположение отеля.

stars

integer

Количество звезд. Принимает значение от 1 до 5 или может отсутствовать.

check_in

object

Время заезда в отель. Параметр может отсутствовать.

check_out

object

Время выезда из отеля. Параметр может отсутствовать.

total_review_count

integer

Количество отзывов.

total_image_count

integer

Количество изображений (фотографий) отеля.

ratings

object

Информация о рейтинге отеля.

location_features

object

Особенности расположения отеля.

amenities

object

Информация об удобствах отеля.

location object

country_name

string

Страна.

settlement

object

Населенный пункт. Параметр может отсутствовать для загородного отеля.

address

string

Адрес отеля.

lon

double

Долгота координат отеля.

lat

double

Широта координат отеля.

check_in object

from

string

Время, начиная с которого возможно заселение в номер, в формате hh:mm.

until

string

Окончание заселения в формате hh:mm. Параметр может принимать значение null или отсутствовать.

check_out object

from

string

Время, начиная с которого можно сдать номер, в формате hh:mm. Параметр может принимать значение null или отсутствовать.

until

string

Время, до которого необходимо сдать номер, в формате hh:mm.

ratings object

rating

string

Рейтинг отеля. Принимает значение от 1 до 5 в формате: дробное число, один знак после запятой, или может отсутствовать.

teaser

string

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

feature_ratings

object

Список оценок отеля. Параметр может отсутствовать.

location_features object

type

string

Типы расположения отеля. Возможные значения:

  • METRO — станция метро;
  • STATION — станция общественного транспорта;
  • OTHER — остальное.

name

string

Название станции метро / общественного транспорта или другого ориентира.

coordinates

object

Координаты станции метро / общественного транспорта или другого ориентира.

distance_meters

integer

Расстояние в метрах от станции метро / общественного транспорта или другого ориентира до отеля.

metro_line

object

Линия метро. Параметр присутствует, если в location_features вернулось значение "type": "METRO".

amenities object

groups

object

Группы удобств.

settlement object

type

string

Тип населенного пункта. Возможные значения:

  • CITY — город;
  • VILLAGE — деревня/село.

name

string

Название населенного пункта.

feature_ratings object

name

string

Критерий оценки, например питание.

positive_percent

integer

Процент позитивных оценок.

coordinates object

lon

double

Долгота.

lat

double

Широта.

metro_line object

name

string

Название линии метро.

color

string

Цвет линии в HTML-кодировке.

groups object

name

string

Название группы удобств.

amenities

object

Удобства группы.

amenities object

id

string

Идентификатор удобства.

name

string

Название удобства.

is_important

boolean

Признак основного удобства. Если параметр отсутствует, это означает, что его значение false.

Пример ответа

{
  "hotel_id": "1019057204",
  "name": "Марриотт Москва Гранд Отель",
  "location": {
    "country_name": "Россия",
    "settlement": {
      "type": "CITY",
      "name": "Москва"
    },
    "address": "Москва, ул. Добролюбова, д. 11",
    "lon": 37.599343,
    "lat": 55.768301,
  },
  "stars": 5,
  "check_in": {
    "from": "14:00",
    "until": null
  },
  "check_out": {
    "from": null,
    "until": "12:00"
  },
  "total_reviews_count": 158,
  "total_image_count": 79,
  "ratings": {
    "rating": "4.9",
    "teaser": "100% гостей понравилось питание",
    "feature_ratings": [
      {
        "name": "Питание",
        "positive_percent": 100
      },
    ]
  },
  "location_features": [
    {
      "type": "METRO",
      "name": "Маяковская",
      "coordinates": {
        "lon": 37.597196974,
        "lat": 55.769448461
      },
      "distance_meters": 192,
      "metro_line": {
        "name": "Замоскворецкая линия",
        "color": "#3aa63a",
      }
    },
    {
      "type": "STATION",
      "name": "ост. «Глазная больница»",
      "coordinates": {
        "lon": 37.600294766,
        "lat": 55.767682396
      },
      "distance_meters": 95,
    },
    {
      "type": "OTHER",
      "name": "1,8 км до центра",
    }
  ],
  "amenities": {
    "groups": [
      {
        "name": "Интернет",
        "amenities": [
          {
            "id": "internet access",
            "name": "Доступ в интернет: на всей территории отеля",
            "is_important": true,
          },
        ]
      },
    ]
  },
}
Написать в службу поддержки
Предыдущая
Получение списка отельных сниппетов с доступными предложениями
Следующая
Получение списка фотографий отеля