Получение отзывов об отеле

Возвращает отзывы об отеле по идентификатору. Метод поддерживает paging.

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

GET https://whitelabel.travel.yandex-net.ru/hotels/hotel/reviews/
  ? hotel_id=<string>
  & [page_limit=<integer>]
  & [page_token=<string>]
  & [order_by=<enum of string>]
  & [affiliate_clid=<string>]

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

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

Параметр	Описание
`hotel_id`*	Идентификатор отеля.
`page_limit`	Размер запрашиваемого блока (страницы). Максимальное значение — 50.
`page_token`	Токен начала запрашиваемого блока (страницы). Для первой страницы должен быть пустым. Приходит вместе с предыдущей страницей в поле `next_page_token`.
`affiliate_clid`	Идентификатор, выданный партнеру сервисом Яндекс Дистрибуция, к которому относится запрос. При отсутствии параметра будет использован clid, установленный партнеру при регистрации в системе.

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

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

https://whitelabel.travel.yandex-net.ru/hotels/hotel/reviews/?hotel_id=1019057204&page_limit=10
&page_token=20

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

{
  "total_review_count": (integer),
  "reviews" : [
    {
      "text": "(string)",
      "updated_at": "(string)",
      "rating": (integer),
      "total_like_count": (integer),
      "total_dislike_count": (integer),
      "images" : [
        {
          "url_template": "(string)",
          "sizes": [
            {
              "size": "(string)",
              "height": (integer),
              "width": (integer)
            }
          ]
        }
      ],
    },
  ],
  "next_page_token": "(string)"
}

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

Параметр	Тип	Описание
`total_review_count`	integer	Общее количество отзывов по отелю.
`reviews`	object	Отзывы по отелю.
`next_page_token`	string	Токен следующей страницы (`not null` — признак того, что есть еще отели). Его необходимо передать для получения следующей страницы в параметре запроса `page_token`. Параметр может отсутствовать.
reviews object
`text`	string	Текст отзыва.
`updated_at`	string	Дата и время последнего обновления в формате UTC (стандарт ISO 8601): `YYYY-MM-DDThh:mm:ss.sssZ`.
`rating`	integer	Рейтинг отеля. Принимает значение от 0 до 5.
`total_like_count`	integer	Количество лайков отзыва.
`total_dislike_count`	integer	Количество дизлайков отзыва.
`images`	object	Список изображений, загруженных пользователем в отзыв.
images object
`url_template`	string	Шаблон URL изображения, в котором `%s` нужно заменить на код определенного размера для получения URL изображения.
`sizes`	array	Список доступных размеров изображения.
sizes object
`size`	string	Код размера изображения, который подставляется в шаблон URL.
`height`	integer	Высота в пикселях.
`width`	integer	Ширина в пикселях.

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

{
  "total_review_count": 1583,
  "reviews" : [
    {
      "text": "Приятный отель с хорошим месторасположением. ... \nВ целом отель рекомендую, приятного отдыха!",
      "updated_at": "2022-08-15T06:04:01.118Z",
      "rating": 4,
      "total_like_count": 3,
      "total_dislike_count": 0,
      "images" : [
        {
          "url_template": "https://avatars.mds.yandex.net/get-altay/200322/2a0000015b0b6a243dc584f534df710b4480/%s",
          "sizes": [
            {
              "size": "XXL",
              "height": 640,
              "width": 1024
            }
          ]
        }
      ],
    },
  ],
  "next_page_token": "30"
}

Написать в службу поддержки

Была ли статья полезна?

Получение списка номеров и предложений отеля

Получение списка лучших предложений