google-hotels/
hotel-prices

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

Hotel Price Tracker API

Календарь цен по дням
Строка на каждую дату заезда
Валюта на выбор
Запрос по ID отеля
4 кредита за запрос
Готово
Готово

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

README

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

Hotel Price Tracker

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

Возможности Hotel Price Tracker API

  • Календарь в виде строкКаждая строка — одна дата заезда; check_out — следующий день, а price.amount, price.currency и отформатированная цена показывают самую низкую цену этой ночи.
  • Несколько недель за запросОдин запрос обычно охватывает 6–8 недель дат заезда, поэтому не нужно запрашивать каждую дату отдельно.
  • Начальная дата на выборcheck_in задаёт начало календаря и указывается вместе с check_out; без него календарь начинается с завтрашнего дня.
  • Строки по отелю и датеКаждая строка содержит hotel_id и name, а id объединяет ID отеля и дату заезда, поэтому результаты повторных запусков легко сводить.

Параметры Hotel Price Tracker 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.

Как использовать Hotel Price Tracker API

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

  1. Отправьте {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} методом POST на /v1/google-hotels/hotel-prices.
  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/hotel-prices" \
  -H "Authorization: Bearer $SOCQ_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"hotel_id":"ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB","currency":"USD"}'

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

  • Поиск самой дешёвой ночи: Отсортируйте по price.amount и выберите самую выгодную дату заезда на ближайшие недели для планирования поездки.
  • Будни против выходных: Сгруппируйте по дню недели check_in и посчитайте, насколько ночи с пятницы и субботы дороже будних.
  • Отслеживание изменений цен: Регулярно получайте календарь, сравнивайте цену одного и того же id между запусками и отмечайте, когда отель повышает или снижает тарифы.
  • Сравнение с конкурентами: Получите календари нескольких соседних отелей в одной валюте и выровняйте их по check_in, чтобы сравнить ценовое преимущество по каждой ночи.

Практические советы по Hotel Price Tracker API

  • Сохраняйте строки по id, объединяющему отель и дату заезда: тогда ежедневный запуск обновляет ту же ночь, а не создаёт дубликаты.
  • Чтобы увидеть более дальние даты, сдвиньте check_in вперёд и повторите запрос.
  • Оставляйте currency неизменной, когда сравниваете несколько отелей или несколько запусков.
  • Запрос стоит 4 кредита независимо от числа возвращённых дат, поэтому календарь выгоднее, чем запросы по каждой дате отдельно.

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

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

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

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

Hotel Price Tracker API — FAQ

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

Каждая строка — цена одной ночи: check_out — день после check_in, а price — самая низкая цена этой ночи.

Обычно на 6–8 недель от начальной даты. С check_in он начинается в этот день, без него — с завтрашнего дня.

В той, что задана в currency трёхбуквенным кодом, например USD или EUR. В каждой строке указана валюта её цены.

4 кредита за запрос, который возвращает полный календарь одного отеля.