Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Booking: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Ищите отели, апартаменты и другое жильё на Booking.com по направлению. | $1.39 за 1 000 запросов | Норма |
Сведенияprofile | Получите один объект Booking.com по ссылке на страницу /hotel/: описание, тип, официальные звёзды, оценку гостей с оценками по категориям, удобства, адрес и указанную цену. | $1.39 за 1 000 запросов | Норма |
Отзывыreviews | Собирайте отзывы гостей об объекте на Booking.com: отдельно что понравилось и что не понравилось, оценку, месяц проживания, тип путешественника, номер и ответ отеля, если он есть. | $1.39 за 1 000 запросов | Норма |
Ценыprices | Сравнивайте цены номеров объекта на Booking.com по дням. | $1.39 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Booking?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Ищите отели, апартаменты и другое жильё на Booking.com по направлению. Получите официальные звёзды, оценку гостей, цену, условия завтрака, сеть и местоположение. Даты передавайте парой | keyword | check_in, check_out, currency, lang, min_price, property_type, sort, star_rating | Режим выдачи: Sync | Значения в каталоге: defaultLimit=10, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities |
profileСведения Получите один объект Booking.com по ссылке на страницу /hotel/: описание, тип, официальные звёзды, оценку гостей с оценками по категориям, удобства, адрес и указанную цену. Официальные | url | check_in, check_out, currency, lang | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · name · type · url · text · stars · rating · rating_scale · rating_label · review_count · price · currency · breakfast · hotel_chain · check_in_date · check_out_date · address · city · country · latitude · longitude · image_url · platform · category_ratings · image_urls · facilities |
reviewsОтзывы Собирайте отзывы гостей об объекте на Booking.com: отдельно что понравилось и что не понравилось, оценку, месяц проживания, тип путешественника, номер и ответ отеля, если он есть. Любая из двух частей может быть пустой, а выборка может включать не все отзывы. | url | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=100. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $1.39 за 1 000 запросов | id · title · text_positive · text_negative · rating · rating_scale · posted_at · stay_date · author_name · author_country · traveler_type · room_name · nights · language · owner_response · platform |
pricesЦены Сравнивайте цены номеров объекта на Booking.com по дням. Получите тип номера, исходную и текущую цену, налоги, возможность возврата, тип питания и число оставшихся номеров. Окно | url | adults, check_in, currency, days, rooms, start_date | Режим выдачи: Sync | — | $1.39 за 1 000 запросов | id · url · hotel_name · room_name · check_in · check_out · price · original_price · discount_percent · currency · taxes_included · is_sold_out · availability_status · min_stay · bed_type · max_guests · room_size_sqm · meal_plan · is_breakfast_included · is_refundable · rate_options_count · platform · rooms_left · room_view |
Что означают параметры действия search в API Booking?
Ищите отели, апартаменты и другое жильё на Booking.com по направлению. Получите официальные звёзды, оценку гостей, цену, условия завтрака, сеть и местоположение. Даты передавайте парой check_in и check_out. Цены приведены в том виде, как они показаны на сайте, и не фиксируются до оформления бронирования.
keywordОбязательный- Задаёт название направления, например Amsterdam. Действие search использует его для поиска отелей, апартаментов и другого жилья, а не перелётов, достопримечательностей или ключевых слов отзывов.
check_inНеобязательный- Задаёт дату заезда в формате YYYY-MM-DD. Чтобы действия search и profile передали даты проживания, нужны оба параметра: check_in и check_out. Для prices это начальная дата, если start_date не указан. Бронирование не создаётся.
check_outНеобязательный- Задаёт дату выезда в формате YYYY-MM-DD; она должна быть позже check_in и передаваться вместе с ним. Если указать только check_out, диапазон проживания не будет передан в действия search или profile.
currencyНеобязательный- Задаёт валюту отображения цен на жильё, по умолчанию USD. Для действий search и profile принимаются перечисленные коды в нижнем регистре, для prices — трёхбуквенные коды в верхнем регистре. Параметр не меняет оплату API EveryInfra.Допустимые значения:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar langНеобязательный- Задаёт язык страницы объекта, по умолчанию британский английский. Принимает engb или enus для британского или американского английского и zhcn или zhtw для упрощённого или традиционного китайского (не передавайте общие en или zh). Параметр не переводит текст отзывов.Допустимые значения:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw min_priceНеобязательный- Фильтрует объекты по строке диапазона цены за ночь, а не по одному минимальному значению (например, 100-150 для диапазона или 100+ для цены от 100). Валюта задаётся параметром currency; полная стоимость проживания не поддерживается.
property_typeНеобязательный- Фильтрует результаты поиска по категории жилья с сохранением регистра и пробелов (например, Hotels, Apartments, Hostels, Guest houses, Homestays, Bed and breakfasts, Holiday homes, Boats, Villas, Motels, Resorts, Holiday parks, Campsites, Luxury tents или none без ограничения). Параметр фильтрует категории объектов, а не типы номеров.
sortНеобязательный- Сортирует объекты: distance по расстоянию от location, popular по сводному рейтингу отзывов или top_rated по звёздности, а не по оценке гостей. В search по умолчанию используется popular, в запросах profile сортировка игнорируется.Допустимые значения:
distancepopulartop_rated star_ratingНеобязательный- Фильтрует объекты по звёздности: от 1_star до 5_stars, unrated для объектов без звёзд или any, чтобы снять ограничение. Звёздность объекта не связана с оценками в отзывах гостей.Допустимые значения:
1_star2_stars3_stars4_stars5_starsanyunratedBooking: звёздный рейтинг, оценки в отзывах и рейтинг качества — У Booking отдельные определения для звёздного рейтинга объекта, оценок в отзывах гостей и рейтинга качества. Звёздный рейтинг от 1 до 5 отличается от оценки гостей от 1 до 10, и его нельзя путать с рейтингом качества в виде жёлтых квадратов. · Проверено
Что означают параметры действия profile в API Booking?
Получите один объект Booking.com по ссылке на страницу /hotel/: описание, тип, официальные звёзды, оценку гостей с оценками по категориям, удобства, адрес и указанную цену. Официальные stars и оценка гостей rating являются разными показателями. Указание дат не фиксирует цену.
urlОбязательный- Задаёт полный URL страницы одного объекта, желательно с путём /hotel/. Используется действием profile для получения сведений, действием reviews — для отзывов об объекте и действием prices — для проверки цен на номера. URL поиска по направлению не поддерживаются.Booking: звёздный рейтинг и оценки в отзывах на страницах объектов — Booking разделяет звёздный рейтинг объекта, оценки в отзывах гостей и рейтинг качества. Действие profile читает одну публичную страницу объекта по URL; этот источник объясняет возвращаемые термины рейтинга и не превращает рейтинг в фильтр запроса или гарантию бронирования. · Проверено
check_inНеобязательный- Задаёт дату заезда в формате YYYY-MM-DD. Чтобы действия search и profile передали даты проживания, нужны оба параметра: check_in и check_out. Для prices это начальная дата, если start_date не указан. Бронирование не создаётся.
check_outНеобязательный- Задаёт дату выезда в формате YYYY-MM-DD; она должна быть позже check_in и передаваться вместе с ним. Если указать только check_out, диапазон проживания не будет передан в действия search или profile.
currencyНеобязательный- Задаёт валюту отображения цен на жильё, по умолчанию USD. Для действий search и profile принимаются перечисленные коды в нижнем регистре, для prices — трёхбуквенные коды в верхнем регистре. Параметр не меняет оплату API EveryInfra.Допустимые значения:
aedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar langНеобязательный- Задаёт язык страницы объекта, по умолчанию британский английский. Принимает engb или enus для британского или американского английского и zhcn или zhtw для упрощённого или традиционного китайского (не передавайте общие en или zh). Параметр не переводит текст отзывов.Допустимые значения:
arbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw
Что означают параметры действия reviews в API Booking?
Собирайте отзывы гостей об объекте на Booking.com: отдельно что понравилось и что не понравилось, оценку, месяц проживания, тип путешественника, номер и ответ отеля, если он есть. Любая из двух частей может быть пустой, а выборка может включать не все отзывы.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеurlОбязательный- Задаёт полный URL страницы одного объекта, желательно с путём /hotel/. Используется действием profile для получения сведений, действием reviews — для отзывов об объекте и действием prices — для проверки цен на номера. URL поиска по направлению не поддерживаются.Booking: отзывы гостей и оценки по категориям — В документации Booking отмечено, что общая оценка в отзыве и оценки по отдельным категориям выставляются независимо. Здесь приводится трактовка с официального сайта; шкалу оценок в этом действии API всё равно нужно проверять для каждого формата входных данных, а ссылка на этот источник не подтверждает, что нормализация проверена. · Проверено
Что означают параметры действия prices в API Booking?
Сравнивайте цены номеров объекта на Booking.com по дням. Получите тип номера, исходную и текущую цену, налоги, возможность возврата, тип питания и число оставшихся номеров. Окно days по умолчанию составляет 7 дней, максимум 30. В каждой записи check_in и check_out содержат ежедневное время заезда и выезда в отеле, а не ваши даты.
urlОбязательный- Задаёт полный URL страницы одного объекта, желательно с путём /hotel/. Используется действием profile для получения сведений, действием reviews — для отзывов об объекте и действием prices — для проверки цен на номера. URL поиска по направлению не поддерживаются.
adultsНеобязательный- Задаёт число взрослых гостей для запросов цен: целое число, по умолчанию 2. Используется только как параметр запроса цен, не ограничивает число возвращаемых вариантов номеров и не создаёт бронирование. Поиск всегда выполняется для 2 взрослых.
check_inНеобязательный- Задаёт дату заезда в формате YYYY-MM-DD. Чтобы действия search и profile передали даты проживания, нужны оба параметра: check_in и check_out. Для prices это начальная дата, если start_date не указан. Бронирование не создаётся.
currencyНеобязательный- Задаёт валюту отображения цен на жильё, по умолчанию USD. Для действий search и profile принимаются перечисленные коды в нижнем регистре, для prices — трёхбуквенные коды в верхнем регистре. Параметр не меняет оплату API EveryInfra.
daysНеобязательный- Задаёт, на сколько календарных дней вперёд запрашивать цены: по умолчанию 7, допустимо от 1 до 30 (значения вне диапазона приводятся к ближайшей границе). Определяет диапазон дат запроса, а не продолжительность проживания для отдельных тарифов номеров.Booking: от чего зависят цены и налоги — По данным Booking, цены устанавливают сами средства размещения, а налоги и сборы зависят от местоположения, типа номера и количества гостей. Что входит в цену, смотрите в описании каждого тарифа; это действие выполняет запрос и не гарантирует бронирование или цену. · Проверено
roomsНеобязательный- Задаёт число номеров для запросов цен: целое число, по умолчанию 1. Определяет запрашиваемое количество номеров, а не число возвращаемых вариантов. Поиск всегда выполняется для 1 номера.
start_dateНеобязательный- Задаёт начальную дату в формате YYYY-MM-DD для получения цен по дням в действии prices. Если указаны оба параметра, переопределяет check_in. Не обозначает дату публикации отзывов или открытия объекта.
Как использовать API Booking
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"booking","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Booking
Какие данные можно получить через API Booking?
Укажите в platform значение booking. В текущем каталоге: поиск, сведения, отзывы и цены. Эти названия действий соответствуют разным объектам или представлениям Booking; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Booking?
Задаёт название направления, например Amsterdam. Действие search использует его для поиска отелей, апартаментов и другого жилья, а не перелётов, достопримечательностей или ключевых слов отзывов. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Booking?
Объявленная схема включает name, type, text и stars. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Booking возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.