Google Hotelsцены на отелиданные о путешествияхмониторинг ценруководство по API

Google Hotels API: поиск отелей, данные об отеле и календарь цен за ночь

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

SocQОбновлено 19 ноября 2026 г.7 мин чтения

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

2026-11-17 SocQ запустил платформу Google Hotels с тремя эндпоинтами, которые делают именно это. Они связаны между собой одним полем — id отеля. В этом руководстве описано, что возвращает каждый из них, как выглядит запрос, сколько он стоит и когда его использовать.

Коротко: найдите отели по направлению через POST /v1/google-hotels/search и сохраните id каждого отеля. Передайте его как hotel_id в POST /v1/google-hotels/hotel-details, чтобы получить удобства, темы отзывов и предложения сайтов бронирования, или в POST /v1/google-hotels/hotel-prices, чтобы получить минимальную цену за ночь по дате заезда. Результаты забирайте через опрос GET /v1/tasks/{task_id}.

Новые эндпоинты Google Hotels

1 кредит SocQ = $0.005.

ЭндпоинтЧто возвращаетЦена
Google Hotels APIОтели по направлению со звездами, оценкой гостей, числом отзывов, минимальной ценой за ночь на ваши даты, расположением, фотографиями и id отеля0.15 кредита ($0.00075) за отель
Google Hotel Details APIАдрес, телефон, сайт, удобства, оценки расположения, распределение оценок, темы отзывов, оценки на других сайтах и предложение каждого сайта бронирования для одного отеля2 кредита ($0.01) за вызов
Hotel Price Tracker APIОдна строка на каждую дату заезда с минимальной ценой отеля за одну ночь, обычно на шесть-восемь недель вперед4 кредита ($0.02) за вызов

Аутентификация и асинхронные задачи

Все запросы к SocQ аутентифицируются API-ключом, и один и тот же заголовок используется для отправки задачи, проверки статуса и получения результатов:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Каждый сбор данных выполняется как фоновая задача:

submit -> task_id -> queued -> running -> succeeded
                                   \-> failed

Ответ на отправку содержит data.task_id и data.status. Опрашивайте задачу по этому ID:

curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
  -H "Authorization: Bearer $SOCQ_API_KEY"

Когда status равен succeeded, ответ содержит первую страницу нормализованных записей в data.results.items. По умолчанию limit равен 50, максимум 500; если has_more равно true, передайте results.next_cursor как cursor, чтобы прочитать следующую страницу. Пока задача находится в состоянии queued, running или failed, эндпоинт возвращает метаданные задачи без results.

Необязательный callback_url в теле запроса заставляет SocQ отправить один POST со сводкой задачи после ее завершения; сами записи читайте через GET /v1/tasks/{task_id}. Тайм-аут на стороне клиента не отменяет задачу, поэтому продолжайте с тем же ID задачи, а не платите за дубликат. 402 означает недостаточно кредитов; 429 означает, что ключ достиг лимита запросов или кредитов.

Google Hotels API: поиск по направлению

Google Hotels API ищет отели так же, как это делают путешественники в Google. Укажите направление или поисковый запрос по отелям в query.

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
  }'

Необязательные поля:

  • check_in и check_out (YYYY-MM-DD, передаются вместе, до 30 ночей) задают цену для конкретного проживания. Без них цены указываются за одну ночь начиная с завтрашнего дня.
  • currency: трехбуквенный код, например USD или EUR.
  • sort_by: relevance, lowest_price, highest_rating или most_reviewed.
  • min_price и max_price: диапазон цены за ночь в выбранной валюте.
  • location_code (по умолчанию 2840, США) и language_code (по умолчанию en).
  • results_limit: от 1 до 140, по умолчанию 18.

У каждой строки отеля есть id, name, stars (от 1 до 5), rating (от 1 до 5), reviews_count, price (amount, currency, formatted), check_in и check_out, к которым относится цена, is_sponsored, location с широтой и долготой, images и rank в результатах. 18 отелей по умолчанию стоят 2.7 кредита ($0.0135); максимальные 140 — 21 кредит ($0.105). Документация: поиск Google Hotels.

Google Hotel Details API: все об одном объекте

Google Hotel Details API возвращает одну строку со всем, что Google Hotels знает об объекте. Передайте id из результата поиска как hotel_id. Добавьте check_in и check_out, чтобы получить предложения на эти даты; иначе предложения будут за одну ночь начиная с завтрашнего дня.

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"
  }'

Помимо полей поиска, строка с данными об отеле заполняет:

  • address, phone, website, check_in_time, check_out_time и amenities.
  • location_scores от 1 до 5 для overall, things_to_do, restaurants, transit и airport_access.
  • rating_distribution — доля отзывов с каждой оценкой в звездах.
  • review_topics, например Location или Breakfast, с числом позитивных, негативных и всех упоминаний.
  • other_reviews — оценка отеля и число отзывов на других сайтах отзывов.
  • offers — по одному на сайт бронирования, с seller, price, url для бронирования, is_official, is_sponsored и free_cancellation_until.

offers — это то, что нужно для проверки паритета цен: сравните официальное предложение с онлайн-турагентствами на одни и те же даты. Каждый запрос стоит 2 кредита ($0.01). Неизвестный hotel_id не возвращает строк, но кредиты все равно списываются. Документация: Google Hotel Details.

Hotel Price Tracker API: минимальная цена по дате заезда

Hotel Price Tracker API возвращает в виде строк календарь цен, который стоит за выбором дат в Google Hotels. Для одного отеля вы получаете минимальную цену на каждую ночь заезда, обычно на шесть-восемь недель начиная с даты заезда.

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"
  }'

check_in задает первую дату календаря (если не указан, завтрашний день); передавайте вместе с ним check_out. У каждой строки есть id, составленный из ID отеля и даты, hotel_id, name, check_in, check_out и price. Используйте эндпоинт, чтобы найти самые дешевые ночи для поездки, сравнить на графике цены в выходные и будни или наполнить отчет по мониторингу цен. Каждый запрос стоит 4 кредита ($0.02) независимо от числа дат. Документация: Hotel Price Tracker.

Простой сценарий для конкурентной выборки

  1. Один раз выполните поиск по направлению с sort_by: "most_reviewed" и выберите из результатов свою конкурентную выборку.
  2. Получите Hotel Details для каждого отеля, чтобы сравнить удобства, оценки расположения, темы отзывов и предложения сайтов бронирования.
  3. Запускайте Hotel Price Tracker для каждого отеля по расписанию и сохраняйте каждую строку вместе с ее collected_at.

Для выборки из 10 отелей, отобранных из стандартного поиска на 18 отелей, один запуск — это 2.7 кредита за поиск, 20 кредитов за данные об отелях и 40 кредитов за календари цен: 62.7 кредита, около $0.31. Цены меняются, поэтому считайте каждый запуск снимком. Данные о местном бизнесе, например места и отзывы в Google Maps, описаны в статье API для парсинга Google Maps.

FAQ

Что такое Google Hotels API?

Это набор эндпоинтов SocQ, которые возвращают данные Google Hotels в виде структурированных строк: результаты поиска по направлению, полные данные об одном отеле и календарь цен за ночь. Это эндпоинты SocQ, а не официальный продукт Google.

Где взять hotel_id?

Из поля id в результатах поиска Google Hotels. То же значение подходит для Hotel Details и Hotel Price Tracker.

На какие даты указаны цены?

Если вы передаете check_in и check_out (YYYY-MM-DD, до 30 ночей), цены указаны за это проживание. Без них поиск и данные об отеле показывают цену за одну ночь начиная с завтрашнего дня, а календарь цен начинается с завтрашнего дня.

Можно ли получить цены в другой валюте?

Да. Передайте трехбуквенный код currency, например EUR. Каждый объект цены содержит amount, currency и строку formatted, например USD 176.

Списываются ли кредиты за неверный hotel_id?

Да. Hotel Details не возвращает строк для неизвестного hotel_id, но все равно списывает 2 кредита, поэтому сначала сверяйте ID с недавним поиском.

GOOGLE HOTELS API

Проверить сценарий на публичном URL Google Hotels

Отправляйте публичные входные данные и получайте нормализованные записи с отслеживаемым источником.

API для Google Hotels