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.
Простой сценарий для конкурентной выборки
- Один раз выполните поиск по направлению с
sort_by: "most_reviewed"и выберите из результатов свою конкурентную выборку. - Получите Hotel Details для каждого отеля, чтобы сравнить удобства, оценки расположения, темы отзывов и предложения сайтов бронирования.
- Запускайте 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