В статье вы найдёте необходимую информацию для работы с 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
- Подключитесь к программе Яндекс Путешествия в личном кабинете Travelpayouts.
- Отправьте запрос на получение доступа к API Яндекс Путешествий в нашу службу поддержки: support@travelpayouts.com.
Важно! В письме, пожалуйста, укажите вашу почту на домене @yandex. Это обязательное требование для получения доступа! - Получите подтверждение от команды поддержки, после чего перейдите по следующей ссылке:
- Авторизуйтесь с помощью логина (почта на домене @yandex, которую вы указывали в письме). Если всё указано верно – отобразится ваш токен.
Полученный токен используйте в запросах к API. Для этого укажите в заголовке:
Authorization: OAuth <OAuth token>
Токен действует в течение одного года. После нужно повторно обратиться в службу поддержки, чтобы получить новый.
Важно!
Всё ссылки, полученные с помощью API, нужно обязательно вставить в форму создания ссылок на странице программы Яндекс Путешествия в поле Адрес целевой страницы, чтобы получить партнёрскую ссылку, содержащую ваш партнёрский маркер.