---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.1
alternate:
  - https://yandex.ru/dev/travel-partners-api/doc/ru/feed-api.md
---
# Получение статического списка отелей

Метод позволяет получить ссылку на скачивание сжатого gz-файла со списком отелей, разделенных переводом строки. Каждый отель представляет собой документ в формате JSON, который содержит статическую или редко изменяемую информацию об отелях.

{% note info %}

Цены и наличие предложений являются динамической информацией и запрашиваются через API отдельно.

{% endnote %}

## Формат запроса {#input}

```
GET https://whitelabel.travel.yandex-net.ru/feeds/hotels/temporary_url

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

```

## Формат ответа {#output}

```json
{
   "url": "(string)",
   "expires_at": "(string)"
}

```

Структура отеля в списке:

```json
{
  "hotel_id": (integer),
  "hotel_url": "(string)",
  "names": [
    {
      "locale": "(string)",
      "value": "(string)"
    }
  ],
  "location": {
    "addresses": [
      {
        "components": [
          {
            "kind": "(string)",
            "value": "(string)"
          }
        ],
        "formatted": "(string)",
        "locale": "(string)"
      }
    ],
    "country_code": "(string)",
    "lat": (double), 
    "lon": (double)
  },
  "types": [
    "(string)"
  ],
  "stars": "(string)",
  "rating": (double),
  "check_in": "(string)",
  "check_out": "(string)",
  "total_review_count": (integer),
  "boolean_features": [
    "(string)"
  ],
  "value_features": [
    {
      "id": "(string)",
      "value": [
        "(string)"
      ]
    },
  ],
  "images": [
    {
      "url_template": "(string)", 
      "sizes": [
        {
          "size": "(string)",
          "height": (integer),
          "width": (integer)
        }
      ]
    }
  ] 
}
```

## Параметры ответа {#output-params}

#|
|| **Параметр** |**Тип**| **Описание** ||
||`url`|string|Ссылка для скачивания файла.||
||`expires_at`|string|Дата и время окончания действия ссылки в формате UTC (стандарт ISO 8601): `YYYY-MM-DDThh:mm:ss.sssZ`.||
|#


Параметры отеля в списке:

#|
|| **Параметр** |**Тип**| **Описание** ||
||`hotel_id`|integer|Идентификатор отеля.||
||`hotel_url`|string|Ссылка на страницу отеля.||
||`names`|object|Название отеля с локализацией.||
||`location`|object|Географическое расположение отеля с локализацией.||
||`types`|string|Типы жилья. Возможные значения:
- `hotel` — отель;
- `sanatorium` — санаторий;
- `holiday-home` — дом отдыха;
- `hostel` — хостел;
- `tourist-resort` — туристический курорт;
- `camping` — кемпинг;
- `farm-holiday` — отдых на ферме;
- `ski-base` — лыжная база;
- `ski-resort` — лыжный курорт;
- `residential complex` — жилой комплекс.||
||`stars`|string|Количество звезд. Принимает значение от 1 до 5 или `null`, а также может отсутствовать.||
||`rating`|double|Рейтинг отеля. Принимает значение от 1 до 5 (в формате — дробное число, один знак после запятой) или `null`, а также может отсутствовать.||
||`check_in`|object|Время, начиная с которого возможно заселение в номер, в формате `hh:mm`. Параметр может принимать значение `null` или отсутствовать.||
||`check_out`|object|Время, до которого необходимо сдать номер, в формате `hh:mm`. Параметр может принимать значение `null` или отсутствовать.||
||`total_review_count`|integer|Количество отзывов об отеле.||
||`boolean_features`|array|Особенности и удобства, которые могут быть в отеле. Возможные значения:
- `wi_fi` — Wi-Fi;
- `wired_internet` — интернет;
- `car_park` — парковка;
- `minibar` — мини-бар;
- `pets` — возможно проживание с животными;
- `transfer` — трансфер;
- `has_restaurant` — ресторан;
- `cafe` — кафе;
- `baggage_room` — камера хранения;
- `laundry` — прачечная;
- `dry_cleaning` — химчистка;
- `payment_by_credit_card` — оплата картой;
- `washing machine` — стиральная машина;
- `heating` — отопление;
- `around the clock front desk` — круглосуточная стойка регистрации;
- `room service` — обслуживание номеров;
- `shared toilet` — общий туалет;
- `express check in out` — ускоренная регистрация заезда/отъезда;
- `safe` — сейф;
- `refrigerator` — холодильник;
- `minibar` — мини-бар;
- `air_conditioning` — кондиционер в номере;
- `hairdryer` — фен;
- `tea coffee in rooms` — чай/кофе в номерах;
- `TV in room` — телевизор в номере;
- `iron` — утюг;
- `cleaning` — уборка;
- `non smoking rooms` — номера для некурящих;
- `pool` — бассейн;
- `gym` — тренажёрный зал;
- `pharmacy` — аптека;
- `bellboy` — носильщик;
- `meeting room` — переговорная;
- `bathrobe` — халат;
- `slippers` — тапочки;
- `rooms with soundproofing` — номера со звукоизоляцией;
- `hotel_sea_nearby` — рядом с морем;
- `hotel_city_center_nearby` — рядом с центром;
- `hotel_airport_nearby` — рядом с аэропортом;
- `hotel_park_nearby` — рядом с парком;
- `ventilator` — вентилятор;
- `animals allowed to be accommodated` — животные разрешенные к размещению;
- `yandex_smart_speaker` — имеется Яндекс Станция с Алисой.||
||`value_features`|object|Характеристики отеля.||
||`images`|object|Список изображений (фотографий) отеля.||
||**names object**|||
||`locale`|string|Локаль названия в формате UTF-16 (стандарт ISO 639-1).||
||`value`|string|Значение.||
||**location object**|||
||`addresses`|object|Адреса отелей.||
||`country_code`|string|Код страны в формате UTF-16 (стандарт ISO 3166-1).||
||`lat`|double|Широта координат отеля.||
||`lon`|double|Долгота координат отеля.||
||**value_features object**|||
||`id`|string|Идентификатор характеристики отеля. Возможные значения:
- `internet_in_hotel` — интернет в отеле;
- `internet access` — доступ в интернет;
- `parking type` — тип парковки;
- `type_food` — тип питания;
- `year_of_foundation` — дата постройки;
- `reconstruction_year` — дата реконструкции;
- `number of restaurants` — количество ресторанов;
- `free transfer` — трансфер;
- `type of transfer` — тип трансфера;
- `safe type` — тип сейфа;
- `kitchen equipment` — оборудование для кухни;
- `cleaning frequency` — частота уборки;
- `animal accommodations` — размещение животных;
- `animals allowed to be accommodated` — животные, допустимые к размещению;
- `restrictions on living with animals` — ограничения на проживание с животными;
- `number of meeting rooms` — количество переговорных;
- `hotel_sea_distance_meters` — расстояние до моря;
- `hotel_city_center_distance_meters` — расстояние до центра города.||
||`value`|string|Характеристики отеля. Набор значений зависит от того, какой `id` вернулся в параметре `value_features`.
- Для `internet_in_hotel` значения:

    - `free internet` — платный;
    - `paid internet` — бесплатный.
- Для`internet access` значения:

    - `in the rooms` — в номерах;
    - `throughout the hotel` — на всей территории отеля.
- Для `parking type` значения:

    - `parking type paid` — платный;
    - `parking type free` — бесплатный.
- Для `type_food` значения:

    - `breakfast_buffet` — только завтрак — шведский стол;
    - `half_board` — полупансион;
    - `on_the_menu` — по меню;
    - `advanced_full_board` — расширенный полный пансион;
    - `full_board` — полный пансион;
    - `extended_half_board` — расширенный полупансион;
    - `without_power` — без питания;
    - `english_breakfast` — английский завтрак;
    - `american_breakfast` — американский завтрак;
    - `continental_breakfast` — континентальный завтрак;
    - `diet_breakfast` — диетический завтрак;
    - `all_inclusive` — всё включено;
    - `ultra_all_inclusive` — ультра всё включено.
- Для `free transfer` значения:

    - `airport` — до/от аэропорта;
    - `railway station` — до/от железной дороги;
    - `beach` — до/от пляжа;
    - `shopping mall` — до/от торгового центра;
    - `port` — до/от порта;
    - `casino` — до/от казино;
    - `ski slope` — до/от лыжного склона;
    - `bus_station` — до/от автобусной остановки;
    - `ferry` — до/от порта.
- Для `type of transfer` значения:

    - `paid transfer` — платный;
    - `free transfer` — бесплатный.
- Для `safe type` значения:

    - `in room safe` — в номере;
    - `safe at the reception` — у администратора;
    - `paid safe` — платный;
    - `free safe` — бесплатный.
- Для `kitchen equipment` значения:

    - `teapot` — чайник;
    - `microwave` — микроволновая печь;
    - `kitchen dishwasher` — посудомойка;
    - `dishes` — посуда;
    - `stove` — кухонная плита;
    - `coffee_maker` — кофеварка.
- Для `cleaning frequency` значения:

    - `daily` — каждый день;
    - `upon request` — по запросу;
    - `on certain days` — в определённые дни.
- Для `animal accommodations` значения:

    - `animal paid` — платно;
    - `animal free` — бесплатно.
- Для `animals allowed to be accommodated` значения:

    - `only cats and dogs` — только кошки и собаки;
    - `dogs only` — только собаки;
    - `cats only` — только кошки;
    - `only service animals` — только служебные животные.
- Для `restrictions on living with animals` значения:

    - `quantity restrictions` — по количеству;
    - `weight restriction` — по весу;
    - `withers_height_restrictions` — по размеру.||
||**images object**|||
||`url_template`|string|Шаблон URL изображения, в котором `%s` нужно заменить на код определенного размера для получения URL изображения.||
||`sizes`|object|Размер изображения.||
||**addresses object**|||
||`components`|object|Компоненты адреса.||
||`formatted`|string|Отформатированный адрес отеля.||
||`locale`|string|Локаль адреса в формате UTF-16 (ICU локали).||
||**sizes object**|||
||`size`|string|Код размера изображения, который подставляется в шаблон URL. Возможные значения:
- `XXXS` — 50x50;
- `XXS` — 75x75;
- `XS` — 100x100;
- `S` — 150x150;
- `M` — 300x300;
- `L` — 500x500;
- `XL` — 800x800;
- `XXL` — 1080x1080;
- `XXXL` — 1280x1280;
- `orig` — оригинальный размер.||
||`height`|integer|Высота в пикселях.||
||`width`|integer|Ширина в пикселях.||
||**components object**|||
||`kind`|string|Типы компонентов адреса. Возможные значения:
- `country` — страна;
- `province` — провинция;
- `area` — местность;
- `locality` — населенный пункт;
- `street` — улица;
- `district` — район;
- `hydro` — водоем. Например, залив, река, озеро;
- `other` — другое;
- `house` — номер дома;
- `airport` — аэропорт;
- `vegetation` — растительность. Например, лесные массивы, скверы, сады, парки;
- `railway` — ж/д станция;
- `route` — маршрут;
- `station` — станция;
- `metro` — станция метро.||
||`value`|string|Значение.||
|#


## Пример ответа {#primer-otveta}

```json
{
   "url": "https://travel-whitelabel-feed.s3-private.mds.yandex.net/testing/hotels.json.gz?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20230629T080151Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3599&X-Amz-Credential=aYgYBmes2dgmzpvizeND%2F20230629%2Fprivate%2Fs3%2Faws4_request&X-Amz-Signature=03e83f...0a3a", 
   "expires_at": "2023-06-29T15:20:03.492Z" 
}

```

Пример структуры отеля в списке:

```json
{
  "hotel_id": 87732700319, 
  "hotel_url": "https://travel.yandex.ru/hotels/nevsehir-nevsehir- tr/anatolian-houses-cave-hotel",
  "names": [
    {
      "locale": "ru",
      "value": "Anatolian Houses Cave Hotel"
    },
    {
      "locale": "en",
      "value": "Anatolian Houses Cave Hotel"
    },
    {
      "locale": "tr",
      "value": "Anatolian Houses Cave Hotel"
    }
  ], 
  "location": {
    "addresses": [
      {
        "components": [
          {
            "kind": "country",
            "value": "Türkiye"
          },
          {
            "kind": "province",
            "value": "Nevşehir"
          },
          {
            "kind": "area",
            "value": "Nevşehir Merkez"
          },
          {
            "kind": "district",
            "value": "Göreme Beldesi"
          },
          {
            "kind": "street",
            "value": "Cevizli Sok."
          }
        ],
        "formatted": "Göreme Beldesi, İsali-Gaferli- Avcılar Mah., Cevizli Sok., Nevşehir Merkez, Nevşehir, Türkiye", 
        "locale": "en"
      },
      {
        "components": [
          {
            "kind": "country",
            "value": "Türkiye"
          },
          {
            "kind": "province",
            "value": "Nevşehir"
          },
          {
            "kind": "area",
            "value": "Nevşehir Merkez"
          },
          {
            "kind": "district",
            "value": "Göreme Beldesi"
          },
          {
            "kind": "street",
            "value": "Cevizli Sok."
          }
        ],
        "formatted": "Göreme Beldesi, İsali-Gaferli- Avcılar Mah., Cevizli Sok., Nevşehir Merkez, Nevşehir, Türkiye",
        "locale": "tr"
      },
      {
        "components": [
          {
            "kind": "country",
            "value": "Турция"
          },
          {
            "kind": "province",
            "value": "Невшехир"
          },
          {
            "kind": "area",
            "value": "НевшехирМеркез "
          },
          {
            "kind": "district",
            "value": "посёлокГёреме "
          },
          {
            "kind": "street",
            "value": "улицаДжевизли "
          }
        ],
        "formatted": "Невшехир,НевшехирМеркез,посёлокГёреме,махаллеГёреме - Исали -Гаферли -Авджилар,улицаДжевизли ",
        "locale": "ru"
      }
    ],
    "country_code": "TR", 
    "lat": 38.642239, 
    "lon": 34.832363 
  }, 
  "types": [
    "hotel"
  ], 
  "stars": "4", 
  "rating": null, 
  "check_in": "14:00", 
  "check_out": "11:30", 
  "total_review_count": 0, 
  "boolean_features": [
    "pool",
    "heating",
    "gym"
  ], 
  "value_features": [
    {
      "id": "internet_in_hotel",
      "value": [
        "free internet"
      ]
    },
    {
      "id": "year_of_foundation",
      "value": [
        "2007"
      ]
    },
    {
      "id": "hotel_city_center_distance_meters",
      "value": [
        "9938"
      ]
    }
  ], 
  "images": [
    {
      "url_template": "https://avatars.mds.yandex.net/get- altay/5517598/2a0000017e32ffeb0d3009a86bca0faa4940/%s", 
      "sizes": [
        {
          "size": "L", 
          "height": 333, 
          "width": 500 
        },
        {
          "size": "M",
          "height": 200,
          "width": 300
        },
        {
          "size": "S",
          "height": 100,
          "width": 150
        }
      ]
    }
  ] 
}
```