Получение статического списка отелей

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

Примечание

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

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

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

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

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

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

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

{
  "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)
        }
      ]
    }
  ] 
}

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

Параметр

Тип

Описание

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

Значение.

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

{
   "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" 
}

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

{
  "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
        }
      ]
    }
  ] 
}