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 из поиска отелей и прочитайте отель одной строкой.
- Отправьте {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} методом POST на /v1/google-hotels/hotel-details.
- Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
- Прочитайте отель из 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.
Связанные API
Помимо Google Hotel Details API, используйте эти API, когда нужен другой тип публичных данных Google Hotels.
- Google Hotels API — Ищите отели в Google Hotels по направлению и получайте для каждого цену за ночь на ваши даты, звёздность, оценку гостей, число отзывов, координаты и ID отеля.
- Hotel Price Tracker API — Получайте по ID отеля его календарь цен в Google Hotels с самой низкой ценой за ночь на каждую дату заезда примерно на 6–8 недель вперёд.