google-hotels/
hotel-details

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

Google Hotel Details API

Цены по сайтам бронирования
Темы отзывов
Распределение оценок
Оценки района
2 кредита за запрос
Готово
Готово

Введите параметры и отправьте запрос. Здесь появятся статус задачи и нормализованные результаты.

README

Автор: SocQ · Обновлено

Google Hotel Details

Карточка отеля в Google Hotels объединяет адрес, телефон, время заезда и список удобств с тем, что говорят гости: долю каждой оценки в звёздах, положительные и отрицательные упоминания таких тем, как расположение или завтрак, и оценки на других сайтах отзывов. Вместе с ценами, которые каждый сайт бронирования и официальный сайт отеля предлагают за одно и то же проживание, она подходит для проверки паритета цен, сравнения с конкурентами и наполнения страниц отелей.

Возможности Google Hotel Details API

  • Цены по сайтам бронированияoffers содержит для каждого продавца цену за ночь и ссылку на бронирование; is_official, is_sponsored и free_cancellation_until отмечают прямой тариф, рекламные размещения и тарифы с бесплатной отменой.
  • О чём говорят гостиreview_topics возвращает positive_count, negative_count и mentions_count по темам вроде Wellness или Breakfast и показывает, какие стороны проживания хвалят, а какие критикуют.
  • Распределение оценок и другие сайтыrating_distribution показывает долю каждой оценки в звёздах, other_reviews — оценку, число отзывов и фрагмент с таких сайтов, как Tripadvisor.
  • Оценки районаlocation_scores оценивает от 1 до 5 расположение в целом, досуг, рестораны, транспорт и доступ к аэропорту, а также указывает название района и координаты.
  • Данные отеля в одной строкеaddress, phone, website, check_in_time, check_out_time, доступные удобства, описание и фотографии возвращаются вместе.
  • Цены на ваши датыcheck_in, check_out и currency задают проживание, к которому относятся цены; без дат берётся одна ночь начиная с завтрашнего дня.

Параметры Google Hotel Details API

ПараметрыОбязательныйОписание
hotel_idОбязательныйID отеля из поля id результата Google Hotels API.
check_inНеобязательныйДата заезда (YYYY-MM-DD, сегодня или позже). Указывается вместе с check_out; без обеих дат цены даются за одну ночь начиная с завтрашнего дня.
check_outНеобязательныйДата выезда (YYYY-MM-DD). Должна быть позже check_in; не более 30 ночей.
currencyНеобязательныйТрёхбуквенный код валюты для цен, например USD или EUR.
location_codeНеобязательныйКод местоположения поискового рынка. По умолчанию 2840 (США).
language_codeНеобязательныйКод языка данных об отеле. По умолчанию en.

Как использовать Google Hotel Details API

Отправьте ID из поиска отелей и прочитайте отель одной строкой.

  1. Отправьте {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} методом POST на /v1/google-hotels/hotel-details.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Прочитайте отель из results.items. has_more и results.next_cursor подчиняются обычным правилам пагинации и для этого результата из одной строки остаются пустыми.
curl -X POST "https://api.socq.ai/v1/google-hotels/hotel-details" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'

Сценарии использования Google Hotel Details API

  • Проверка паритета цен: Сравните прямой тариф с отметкой is_official с ценами онлайн-турагентств на те же даты и найдите продавцов, которые предлагают отель дешевле.
  • Сравнение с конкурентами: Сопоставьте rating_distribution, review_topics и location_scores соседних отелей и посмотрите, в чём каждый выигрывает и где уступает.
  • Полные страницы отелей: Одним запросом получите адрес, удобства, время заезда, фотографии и оценки района для страниц отелей в туристическом сервисе.
  • Анализ мнений гостей: Отсортируйте review_topics по negative_count и найдите темы, на которые гости жалуются чаще всего, например шум или завтрак.

Практические советы по Google Hotel Details API

  • Берите ID из недавнего поиска через Google Hotels API — тогда каждый запрос за 2 кредита вернет именно нужный отель.
  • Повторите те же check_in, check_out и currency, что и в поиске, чтобы цены продавцов совпадали с ценой из списка.
  • Перед сравнением продавцов исключите рекламные размещения по is_sponsored, чтобы сравнение было объективным.
  • При построении графика распределения оценок считайте rating_distribution.share долей от 0 до 1.

Помимо Google Hotel Details API, используйте эти API, когда нужен другой тип публичных данных Google Hotels.

  • Google Hotels API — Ищите отели в Google Hotels по направлению и получайте для каждого цену за ночь на ваши даты, звёздность, оценку гостей, число отзывов, координаты и ID отеля.
  • Hotel Price Tracker API — Получайте по ID отеля его календарь цен в Google Hotels с самой низкой ценой за ночь на каждую дату заезда примерно на 6–8 недель вперёд.

Другие платформы

Объединяйте данные Google Hotels с публичными данными других поддерживаемых соцсетей.

Google Hotel Details API — FAQ

Google Hotel Details API получает по ID отеля его карточку в Google Hotels и возвращает контакты, удобства, оценки района, распределение оценок, темы отзывов, оценки на других сайтах и цену каждого сайта бронирования.

Каждая строка, которую возвращает Google Hotels API, содержит ID отеля в поле id; именно это значение передаётся в hotel_id.

Сайты бронирования, которые Google Hotels показывает для этого проживания. Если участвует официальный сайт отеля, он тоже включается и отмечается is_official.

rating_distribution показывает долю каждой оценки в звёздах, review_topics — положительные и отрицательные упоминания по темам, а other_reviews дополняет их оценками и фрагментами отзывов с внешних сайтов.

Каждый запрос стоит 2 кредита и возвращает отель, соответствующий переданному hotel_id.