API от Яндекс Путешествия

API от Яндекс Путешествий — инструмент для разработчиков, с помощью которого вы сможете получать информацию об отелях и предложения по ним.

К подключению приглашаются контентные проекты с трафиком от 5 000 MAU. В проекте должна преобладать полезная информация на соответствующие темы (путешествия, бронирование отелей, авиа и ж/д билетов). Тем не менее, бренд готов рассматривать заявки от проектов с небольшими отклонениями от основных критериев.

Доступные методы API

Партнёрам доступны следующие методы из раздела «Запрос данных по отелям» (кроме метода GET hotels/hotel/reviews):

Метод Описание
GET hotels/suggest Список регионов и отелей, соответствующих введённому поисковому запросу.
GET hotels/selection Список отельных сниппетов с ознакомительной информацией.
GET hotels/search Список сниппетов отелей с доступными предложениями, подходящими под параметрам поиска.
GET hotels/hotel Информация об отеле по идентификатору.
GET hotels/hotel/images Список фотографий отеля по идентификатору.
GET hotels/hotel/offers Информация о номерах и ценах на них по идентификатору отеля и основным параметрам поиска.
GET hotels/top-offers Список лучших предложений по идентификаторам отелей.
GET feeds/hotels/temporary_url Позволяет получить ссылку на скачивание сжатого gz-файла со статистическим списком отелей.

Как получить доступ к API 

  1. Создайте проект в личном кабинете Travelpayouts с ссылкой на ресурс, где вы будете использовать API. Если проект уже создан, ничего дополнительно делать не нужно.
  2. Отправьте запрос на получение доступа к API Яндекс Путешествий в нашу службу поддержки: support@travelpayouts.com. 
    Важно! В письме, пожалуйста, укажите вашу почту на домене @yandex. Это обязательное требование для получения доступа!
  3. Получите подтверждение от команды поддержки, после чего перейдите по следующей ссылке:
  4. Авторизуйтесь с помощью логина (почта на домене @yandex, которую вы указывали в письме). Если всё указано верно – отобразится ваш ключ-токен.

Полученный ключ-токен используйте в запросах к API. Для этого укажите в заголовке:

Authorization: OAuth <OAuth token>

Ключ-токен действует в течение одного года. После нужно повторно обратиться в службу поддержки, чтобы получить новый.

Важно!

Всё ссылки, полученные с помощью API, нужно обязательно превратить в партнёрские. Для этого:

  1. Перейдите в личный кабинет Travelpayouts и страницу Инструменты;
  2. В верхней части страницы выберите нужный проект, где вы планируете разместить ссылку.
    Обратите внимание! Чтобы получить доступ к формированию партнёрских ссылок, ваш проект должен быть подключен к программе.
  3. Вставьте созданную ссылку в поле Страница сайта;
  4. При необходимости добавьте SUB ID;
  5. Нажмите Создать ссылку и QR-код;
  6. Скопируйте готовую ссылку в нижней части страницы.