API Booking Сведения
Состояние API
- Состояние за 24 ч
- Норма
- Среднее время за 24 ч
- —
- Стабильно / норма
- Доступно
- Ограничено
- Почти недоступно
Последние 24 часа
Последние 30 дней
Получите один объект Booking.com по ссылке на страницу /hotel/: описание, тип, официальные звёзды, оценку гостей с оценками по категориям, удобства, адрес и указанную цену. Официальные stars и оценка гостей rating являются разными показателями. Указание дат не фиксирует цену.
Booking Details получает данные об одном объекте размещения на Booking, определяемом по ссылке на его страницу, и возвращает запись об объекте: название и тип, описание, официальную категорию в звёздах, оценку гостей с её словесным обозначением и числом отзывов, адрес и координаты, бренд сети, условия завтрака, изображения и цену с валютой. Команды по работе с договорами с отелями и управлению доходами используют эту возможность, чтобы составлять профили объектов, с которыми ведут переговоры или конкурируют, а туристические сервисы — чтобы заполнять страницы отелей единообразными данными.
Не смешивайте два показателя качества: stars — официальная категория от 1 до 5, а rating — оценка гостей, которую Booking выставляет по 10-балльной шкале; соответствующая словесная формулировка содержится в rating_label. hotel_chain равен null для независимых отелей. Цены зависят от дат, поэтому передавайте и check_in, и check_out, чтобы узнать цену для конкретного периода проживания, и сохраняйте check_in_date и check_out_date рядом с каждым сохранённым значением price. lang принимает коды локалей Booking, например engb (по умолчанию), enus или zhcn, а не просто en или zh.
Цена: $1.39 за 1 000 запросов ($0.001389 за вызов). Неудачные вызовы и пустые результаты не оплачиваются. Синхронный режим. Для долгих задач добавьте в тело запроса "mode": "async", получите job_id и опрашивайте статус.
Промпт для ИИ
Помогите мне написать скрипт для сбора данных через эндпоинт EveryInfra Booking Сведения (booking/profile).
Как работает эндпоинт:
- Запрос: POST https://api.everyinfra.com/api/v1/social с заголовком Authorization: Bearer <API key>. Читайте ключ из переменной окружения EVERYINFRA_API_KEY и никогда не прописывайте его в коде.
- В теле запроса укажите platform: booking и action: profile, а параметры передайте в params.
- Обязательные параметры:
- url: Задаёт полный URL страницы одного объекта, желательно с путём /hotel/. Используется действием profile для получения сведений, действием reviews — для отзывов об объекте и действием prices — для проверки цен на номера.
- Необязательные параметры:
- 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 — трёхбуквенные коды в верхнем регистре. (допустимые значения: aed / ars / aud / azn / bgn / bhd / brl / cad)
- lang: Задаёт язык страницы объекта, по умолчанию британский английский. Принимает engb или enus для британского или американского английского и zhcn или zhtw для упрощённого или традиционного китайского (не передавайте общие e… (допустимые значения: ar / bg / ca / cs / da / de / el / engb)
- Возвращает один объект. Основные поля: id, name, type, url, text, stars (Звёздность отеля (1–5), официальная оце…), rating, rating_scale, rating_label (Текстовая градация оценки (например, Wo…), review_count, price, currency; всего полей: 25, полный список: https://api.everyinfra.com/api/v1/social/catalog?platform=booking.
- Пример тела запроса:
{
"platform": "booking",
"action": "profile",
"params": {
"url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html"
}
}
- Цена: $1.39 за 1 000 запросов; неудачные и пустые результаты не оплачиваются.
- Для десятков или сотен целей добавьте в тело запроса "mode": "async": вы сразу получите job_id и сможете опрашивать GET https://api.everyinfra.com/api/v1/jobs/{job_id}, чтобы получить результат.
- При ответе 422 исправьте запрос, используя предложенные в ошибке имена параметров и допустимые значения; при ответе 429 или 503 подождите указанное в Retry-After время и повторите попытку.
Прежде чем писать код, спросите меня, какие цели мне нужны, сколько их будет, какие поля мне нужны и в каком формате вывести результат; затем согласуйте со мной план и примерную стоимость.Параметры запроса
| Имя | Расположение | Тип | Обязательный | По умолчанию | Описание |
|---|---|---|---|---|---|
Authorization | header | string | Да | - | Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода. |
platform | body | string | Да | booking | Идентификатор платформы, фиксированное значение. |
action | body | string | Да | profile | Идентификатор возможности, фиксированное значение. |
url | body.params | string | Да | - | Задаёт полный URL страницы одного объекта, желательно с путём /hotel/. Используется действием profile для получения сведений, действием reviews — для отзывов об объекте и действием prices — для проверки цен на номера. URL поиска по направлению не поддерживаются. |
check_in | body.params | date | Нет | - | Задаёт дату заезда в формате YYYY-MM-DD. Чтобы действия search и profile передали даты проживания, нужны оба параметра: check_in и check_out. Для prices это начальная дата, если start_date не указан. Бронирование не создаётся. |
check_out | body.params | date | Нет | - | Задаёт дату выезда в формате YYYY-MM-DD; она должна быть позже check_in и передаваться вместе с ним. Если указать только check_out, диапазон проживания не будет передан в действия search или profile. |
currency | body.params | string (enum) | Нет | - | Задаёт валюту отображения цен на жильё, по умолчанию USD. Для действий search и profile принимаются перечисленные коды в нижнем регистре, для prices — трёхбуквенные коды в верхнем регистре. Параметр не меняет оплату API EveryInfra.Допустимые значенияaedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar |
lang | body.params | string (enum) | Нет | - | Задаёт язык страницы объекта, по умолчанию британский английский. Принимает engb или enus для британского или американского английского и zhcn или zhtw для упрощённого или традиционного китайского (не передавайте общие en или zh). Параметр не переводит текст отзывов.Допустимые значенияarbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw |
Примеры кода
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
-H "Authorization: Bearer $EVERYINFRA_API_KEY" \
-H 'Content-Type: application/json' \
--data-raw '{
"platform": "booking",
"action": "profile",
"params": {
"url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.html"
}
}'Спецификация OpenAPI (JSON)Примеры читают ключ из переменной окружения EVERYINFRA_API_KEY; скопированный код никогда не содержит ваш ключ.
Пример ответа
Получено September 26, 2026 at 08:56 (UTC) вызовом этого API с параметрами из примера кода выше. results и count — реальный ответ этого вызова, из которого удалены персональные данные (имена, никнеймы, аватары, ссылки на профили, контакты). id, billing и quota меняются при каждом вызове, поэтому показана только их структура.
{
"id": "req_…",
"platform": "booking",
"action": "profile",
"results": {
"id": 179810,
"name": "Park Hyatt Tokyo",
"type": "hotel",
"url": "https://www.booking.com/hotel/jp/park-hyatt-tokyo.en-gb.html",
"text": "Get the celebrity treatment with world-class service at Park Hyatt TokyoPark Hyatt Tokyo welcomes you home, thoughtfully crafting each moment with intuitive care to ensure every stay feels personally tailored. Located in Shinjuku, west Tokyo, Park Hyatt Tokyo occupies the 39th to…",
"stars": 5,
"rating": 9.2,
"review_count": 128,
"breakfast": "Buffet",
"address": "Tokyo-to, Tokyo, Shinjuku-ku, Nishishinjuku 3-7-1-2, Japan",
"city": "Tokyo",
"country": "jp",
"latitude": "35.684871080031755",
"longitude": "139.69104677438736",
"image_url": "https://cf.bstatic.com/xdata/images/hotel/max1024x768/909678791.jpg?k=bd70c52af1180cbfa82618a22e8b6db4b822c98835618ea713199b0d4636b55f&o=",
"platform": "booking",
"category_ratings": [
{
"name": "Location",
"score": 9.1
},
{
"name": "Cleanliness",
"score": 9.7
},
{
"name": "Value for money",
"score": 8.5
}
],
"image_urls": [
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/909678791.jpg?k=bd70c52af1180cbfa82618a22e8b6db4b822c98835618ea713199b0d4636b55f&o=&hp=1",
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/909677947.jpg?k=0132e551e1b3f34b69767d6416d778dee86bfd324025f3d0a6d39a2b21e005ca&o=&hp=1",
"https://cf.bstatic.com/xdata/images/hotel/max1024x768/110318598.jpg?k=180b52ab1b8a3cdda7a6a014c2068e381bcfa4dc8573036a19ce57241e6b1018&o=&hp=1"
],
"facilities": [
"4 restaurants",
"Parking",
"Private bathroom"
],
"rating_scale": 10
},
"billing": {
"charged": …,
"charged_usd": …,
"balance_after_usd": …,
…
},
"quota": { … }
}Поля ответа
Бизнес-данные находятся в results. В таблице перечислены поля, которые может содержать запись; значения, которые платформа не показывает, никогда не выдумываются.
| Поле | Значение |
|---|---|
id | Уникальный ID записи на платформе. Уникален только в пределах одной платформы; на разных платформах ID могут повторяться. |
name | Название самого объекта для возможностей по аккаунтам, товарам и компаниям. |
type | Тип записи; значения зависят от возможности (например, video / image / text). |
url | Ссылка на запись на платформе. |
text | Основной текст без HTML возвращается полностью и никогда не обрезается (на нескольких платформах результаты списковых запросов содержат только фрагмент; это указано в примечаниях к полям платформы). |
stars | Звёздность отеля (1–5), официальная оценка оснащения объекта. Это не то же самое, что оценка гостей в rating. |
rating | Рейтинг. Шкала зависит от платформы: rating_scale в той же записи задаёт максимум (обычно 5; у Booking, Douban, iQIYI и NAVER — 10). Перед сравнением между платформами пересчитайте значения с учётом rating_scale, иначе результат сравнения может оказаться обратным. |
rating_scale | Максимальное значение rating в той же записи: 5 для пятизвёздочных шкал, 10 для десятибалльных. Поле присутствует, только если у записи есть рейтинг. |
rating_label | Текстовая градация оценки (например, Wonderful или Very good), определяемая по баллу. |
review_count | Количество отзывов для возможностей по товарам и компаниям. null означает, что значение не раскрыто, а не 0. |
price | Цена числом без символа валюты; см. currency. |
currency | Код валюты цены (например, CNY, USD). Если price есть, а currency равно null, не делайте предположений о валюте. |
breakfast | Информация о завтраке (включён, не включён или за доплату). |
hotel_chain | Гостиничная сеть, к которой относится объект; null для независимых отелей. |
check_in_date | Дата заезда, использованная для этого запроса. |
check_out_date | Дата выезда, использованная для этого запроса. |
address | Полный адрес передаётся как есть. |
city | Название города на языке платформы в исходном виде. |
country | Страна или регион: полное название либо код ISO в зависимости от платформы. Значение передаётся без нормализации. |
latitude | Широта. |
longitude | Долгота. |
image_url | Ссылка на изображение. Возможности с несколькими изображениями могут возвращать массив image_urls. |
platform | Идентификатор исходной платформы. Совпадает со значением platform в запросе (например, xiaohongshu, tiktok). |
category_ratings | Оценки по категориям: у каждой есть название (например, чистота или расположение) и балл; поле отсутствует, если оценок нет. |
image_urls | Массив ссылок на изображения в порядке показа на платформе; поле отсутствует, если изображений нет. |
facilities | Названия удобств и услуг в порядке следования групп на странице; поле отсутствует, если их нет. |
FAQ
Какую ссылку Booking передавать в url?
Полную ссылку на страницу одного объекта, желательно с путём /hotel/, например https://www.booking.com/hotel/jp/park-hyatt-tokyo.html. Страница направления или результатов поиска содержит много объектов и не указывает на какой-то один. Та же ссылка на объект подходит и для Booking Reviews, чтобы получить отзывы гостей, и для Booking Prices, чтобы получить цены на номера.
Чем stars отличается от rating?
stars — официальная звёздность объекта от 1 до 5, которая отражает его оснащение, а не мнение гостей. rating — средняя оценка гостей, на Booking по 10-балльной шкале, что подтверждает rating_scale, а rating_label выражает её словами, например Wonderful или Very good. Скромный отель с довольными гостями может получить оценку выше пятизвёздочного, поэтому анализируйте эти показатели отдельно.
Как получить цену на конкретные даты?
Передайте и check_in, и check_out в формате YYYY-MM-DD, причём дата выезда должна быть позже даты заезда; если указана только одна из них, даты проживания не применяются. price возвращается простым числом с кодом валюты в currency, а параметр currency выбирает валюту отображения из перечисленных кодов. Чтобы получить цены по дням для каждого типа номера в диапазоне дат, используйте Booking Prices.
Ошибки и оплата
- 401
- Ключ отсутствует или недействителен.
- 402
- Недостаточно средств на балансе. Сначала пополните баланс.
- 422
- Недопустимое имя или значение параметра. Исправьте запрос по подсказкам в сообщении об ошибке. Без списания.
- 429
- Достигнут лимит запросов в минуту. Подождите указанное в Retry-After время, затем повторите попытку.
- 503
- Не удалось выполнить. Зарезервированная сумма возвращается на баланс. Если результат неизвестен, проверьте его перед повторной попыткой.
- 200 (пусто)
- Нет данных. Без списания.
Официальные источники
Используются только для проверки объектов и терминов. Они не означают, что платформа разрешила или одобрила работу EveryInfra.
- Booking: звёздный рейтинг и оценки в отзывах на страницах объектов ↗
Booking разделяет звёздный рейтинг объекта, оценки в отзывах гостей и рейтинг качества. Действие profile читает одну публичную страницу объекта по URL; этот источник объясняет возвращаемые термины рейтинга и не превращает рейтинг в фильтр запроса или гарантию бронирования.
Проверено 2026-09-04