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