Наша собственная статистика посещений включена всегда. Google Analytics помогает нам понять, как пользуются нашими публичными страницами (но не вашим рабочим пространством после входа), и включается только с вашего разрешения. См. нашу политику конфиденциальности.

API Booking Сведения

POST

Состояние API

Состояние за 24 ч
Норма
Среднее время за 24 ч
—
  • Стабильно / норма
  • Доступно
  • Ограничено
  • Почти недоступно
Норма

Получите один объект 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 время и повторите попытку.

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

Параметры запроса

ИмяРасположениеТипОбязательныйПо умолчаниюОписание
AuthorizationheaderstringДа-Укажите Bearer, а после него — ваш API-ключ. Создайте ключ в консоли; никогда не указывайте его в URL и не храните в репозитории кода.
platformbodystringДаbookingИдентификатор платформы, фиксированное значение.
actionbodystringДаprofileИдентификатор возможности, фиксированное значение.
urlbody.paramsstringДа-Задаёт полный URL страницы одного объекта, желательно с путём /hotel/. Используется действием profile для получения сведений, действием reviews — для отзывов об объекте и действием prices — для проверки цен на номера. URL поиска по направлению не поддерживаются.
check_inbody.paramsdateНет-Задаёт дату заезда в формате YYYY-MM-DD. Чтобы действия search и profile передали даты проживания, нужны оба параметра: check_in и check_out. Для prices это начальная дата, если start_date не указан. Бронирование не создаётся.
check_outbody.paramsdateНет-Задаёт дату выезда в формате YYYY-MM-DD; она должна быть позже check_in и передаваться вместе с ним. Если указать только check_out, диапазон проживания не будет передан в действия search или profile.
currencybody.paramsstring (enum)Нет-Задаёт валюту отображения цен на жильё, по умолчанию USD. Для действий search и profile принимаются перечисленные коды в нижнем регистре, для prices — трёхбуквенные коды в верхнем регистре. Параметр не меняет оплату API EveryInfra.Допустимые значенияaedarsaudaznbgnbhdbrlcadchfclpcnycopczkdkkegpeurfjdgbpgelhkdhufidrilsinrjodjpykrwkwdkztmdlmxnmyrnadnoknzdomrplnqarronrubsarseksgdthbtrytwduahusdxofzar
langbody.paramsstring (enum)Нет-Задаёт язык страницы объекта, по умолчанию британский английский. Принимает engb или enus для британского или американского английского и zhcn или zhtw для упрощённого или традиционного китайского (не передавайте общие en или zh). Параметр не переводит текст отзывов.Допустимые значенияarbgcacsdadeelengbenusesesaretfifrhehrhuidisitjakoltlvmsnlnoplptbrptptroruskslsrsvthtltrukvizhcnzhtw

Примеры кода

bash
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 меняются при каждом вызове, поэтому показана только их структура.

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