google-hotels/
search

Ищите отели в Google Hotels по направлению и получайте для каждого стоимость ночи на ваши даты, звёздность, оценку гостей, число отзывов, координаты и ID отеля для дальнейших запросов.

Google Hotels API

Поиск по направлению
Цены на ваши даты
Звёзды и оценка гостей
ID отеля для запросов
0,15 кредита за результат
Готово
Готово

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

README

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

Google Hotels

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

Возможности Google Hotels API

  • Поиск так, как ищут путешественникиquery принимает направление вроде hotels in new york или название отеля; отели возвращаются в том порядке, в каком их показывает Google Hotels, а rank содержит позицию каждого.
  • Цены для реальной поездкиcheck_in, check_out и currency задают нужное проживание; каждая строка содержит эти даты, а также price.amount, price.currency и отформатированную цену.
  • Сортировка и диапазон ценsort_by переключает relevance, lowest_price, highest_rating и most_reviewed, а min_price и max_price оставляют только отели в рамках бюджета.
  • Показатели качества для каждого отеляstars — категория отеля, rating — средняя оценка гостей от 1 до 5, reviews_count — число отзывов, на которых она основана.
  • Координаты и фотографииlocation содержит широту и долготу, images — фотографии, которые Google показывает для отеля.
  • ID отеля для следующих запросовid каждой строки можно передать без изменений в Google Hotel Details API и Hotel Price Tracker API, а url ведёт на страницу отеля в Google Hotels.
  • До 140 отелей за запросresults_limit принимает значения от 1 до 140, а is_sponsored отделяет рекламные размещения от обычной выдачи.

Параметры Google Hotels API

ПараметрыОбязательныйОписание
queryОбязательныйПоисковый запрос по направлению или отелю, например hotels in new york или название отеля.
check_inНеобязательныйДата заезда (YYYY-MM-DD, сегодня или позже). Указывается вместе с check_out; без обеих дат цены даются за одну ночь начиная с завтрашнего дня.
check_outНеобязательныйДата выезда (YYYY-MM-DD). Должна быть позже check_in; не более 30 ночей.
currencyНеобязательныйТрёхбуквенный код валюты для цен и диапазона цен, например USD или EUR.
sort_byНеобязательныйПорядок сортировки: relevance, lowest_price, highest_rating или most_reviewed.
min_priceНеобязательныйМинимальная цена за ночь в валюте из currency.
max_priceНеобязательныйМаксимальная цена за ночь в валюте из currency. Не может быть меньше min_price.
location_codeНеобязательныйКод местоположения поискового рынка. По умолчанию 2840 (США).
language_codeНеобязательныйКод языка результатов. По умолчанию en.
results_limitНеобязательныйКоличество возвращаемых отелей (1–140). По умолчанию 18.

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

Выполните поиск по направлению и читайте отели построчно.

  1. Отправьте {"query": "hotels in new york", "currency": "USD", "results_limit": 18} методом POST на /v1/google-hotels/search.
  2. Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded.
  3. Читайте отели из results.items и, пока has_more равно true, запрашивайте следующую страницу через results.next_cursor.
curl -X POST "https://api.socq.ai/v1/google-hotels/search" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"hotels in new york","currency":"USD","results_limit":18}'

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

  • Уровень цен в направлении: Сопоставьте price.amount со stars и rating на одни и те же даты и оцените цены на отели города по категориям.
  • Отбор отелей: Оставьте отели в нужном ценовом диапазоне, у которых rating и reviews_count выше порога, и передайте их id в запросы деталей и цен.
  • Сравнение дат поездки: Запустите ту же query с другими check_in и check_out и объедините результаты по id, чтобы увидеть, как меняются цены в зависимости от дат.
  • Карта гостиничного предложения: Наложите stars и цены на координаты из location и посмотрите, где в районе сосредоточены недорогие и премиальные отели.

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

  • Всегда указывайте currency в поисках, которые собираетесь сравнивать, чтобы price.amount был в одной валюте.
  • Передавайте check_in и check_out только вместе. Проживание дольше 30 ночей или выезд раньше заезда отклоняются ещё до создания задачи.
  • Связывайте последующие запросы по id, а не по названию: отели одной сети в городе часто называются почти одинаково.
  • Каждый возвращённый отель стоит 0,15 кредита, поэтому задавайте results_limit по числу отелей, которые действительно будете изучать.

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

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

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

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

Google Hotels API — FAQ

Google Hotels API ищет отели в Google Hotels по направлению или названию и возвращает для каждого стоимость ночи на ваши даты, звёздность, оценку гостей, число отзывов, координаты, фотографии и ID отеля.

На указанные check_in и check_out, но не более 30 ночей. Без обеих дат цены даются за одну ночь начиная с завтрашнего дня; в каждой строке указаны даты, к которым относится цена.

Да. min_price и max_price ограничивают цену за ночь, а sort_by сортирует по relevance, lowest_price, highest_rating или most_reviewed.

Поиск возвращает поля уровня списка. Передайте id отеля в Google Hotel Details API, чтобы получить адрес, удобства, темы отзывов и цены по сайтам бронирования, или в Hotel Price Tracker API, чтобы получить цены по датам заезда.

0,15 кредита за каждый возвращённый отель, то есть 2,7 кредита за 18 отелей. Поиск, по которому отели не найдены, не тарифицируется.