Ко всем API
Данные Google Hotels

Google Hotels Data APIs

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

Доступные API Google Hotels

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

Какие данные Google Hotels можно получить?

Каждая строка описывает отель или одну ночь, цены указаны в выбранной валюте, а ID отеля связывает все три API.

Списки отелей с ценами

Название, позиция, самая низкая цена за ночь на ваши даты, признак рекламного размещения и ссылка на страницу отеля в Google Hotels.

Оценки и отзывы гостей

Звёздность, средняя оценка гостей от 1 до 5, число отзывов, доля каждой оценки в звёздах и положительные и отрицательные упоминания по темам.

Предложения сайтов бронирования

Цена за ночь и ссылка на бронирование у каждого продавца с отметками официального сайта, рекламных предложений и бесплатной отмены.

Расположение и район

Адрес, координаты, название района и оценки от 1 до 5 для досуга, ресторанов, транспорта и доступа к аэропорту.

Календарь цен за ночь

Самая низкая цена на каждую дату заезда для одного отеля, обычно на ближайшие 6–8 недель.

Какой API Google Hotels выбрать

Все три API используют один и тот же ID отеля, поэтому результат поиска можно сразу передать в запрос карточки или календаря цен.

APIИсходные данныеЧто вы получаете
Google Hotels APIНаправление или название отеля в queryДо 140 отелей с ценой за ночь, звёздностью, оценкой, числом отзывов, координатами и ID
Google Hotel Details APIОдин hotel_idОдна строка с контактами, удобствами, оценками района, распределением оценок, темами отзывов и предложениями сайтов
Hotel Price Tracker APIОдин hotel_idСтрока на каждую дату заезда с самой низкой ценой этой ночи, обычно на 6–8 недель

Как работает API Google Hotels

Все три API используют один и тот же асинхронный процесс задач.

  1. 1. Найдите отели

    Отправьте направление методом POST на /v1/google-hotels/search и сохраните id отелей, за которыми хотите следить.

  2. 2. Изучите подробнее

    Отправьте hotel_id на /v1/google-hotels/hotel-details, чтобы получить карточку и предложения, или на /v1/google-hotels/hotel-prices, чтобы получить календарь цен.

  3. 3. Прочитайте результаты

    Опрашивайте GET /v1/tasks/{task_id}, пока status не станет succeeded, затем читайте строки из results.items.

Поиск отелей в направлении

Авторизуйтесь с помощью API-ключа SocQ и отправьте направление. Каждый возвращённый отель стоит 0,15 кредита.

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

# Poll GET /v1/tasks/{task_id}
# Read the hotels in results.items

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

Ценовые ориентиры по направлениям

Сравнивайте цены за ночь по звёздности и оценке в разных городах на одни и те же даты.

Проверка паритета цен

Сравнивайте официальный тариф отеля с предложениями онлайн-турагентств на то же проживание.

Мониторинг конкурентов

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

Туристический контент и страницы отелей

Наполняйте страницы отелей адресом, удобствами, временем заезда, фотографиями и оценками района.

Планирование поездок

Перед бронированием находите самые дешёвые даты заезда на ближайшие недели.

Правила запросов и тарифы

Эти правила действуют для всех трёх API Google Hotels.

  • Передавайте check_in и check_out вместе в формате YYYY-MM-DD начиная с сегодняшнего дня, для проживания не более 30 ночей; без них цены даются за одну ночь начиная с завтрашнего дня.
  • Задавайте currency трёхбуквенным кодом, например USD или EUR, чтобы цены в разных запросах можно было сравнивать.
  • Google Hotels API возвращает от 1 до 140 отелей за запрос, по умолчанию 18, и стоит 0,15 кредита за каждый возвращённый отель.
  • Google Hotel Details API принимает hotel_id из результата поиска и стоит 2 кредита за запрос.
  • Hotel Price Tracker API принимает hotel_id и стоит 4 кредита за запрос, возвращающий весь календарь.

Частые вопросы об API Google Hotels

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

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

Какие API Google Hotels доступны?

Google Hotels API для поиска, Google Hotel Details API для карточки отеля и предложений сайтов бронирования и Hotel Price Tracker API для его цен по датам заезда.

Откуда берётся hotel_id?

Каждая строка Google Hotels API содержит ID отеля в поле id. Передайте это значение как hotel_id в API карточки и календаря цен.

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

Поиск и карточка используют ваши check_in и check_out, не более 30 ночей, или одну ночь начиная с завтрашнего дня, если даты не указаны. Календарь содержит по одной ночи на каждую дату заезда примерно на 6–8 недель.

Как тарифицируются запросы Google Hotels?

Поиск стоит 0,15 кредита за каждый возвращённый отель, карточка отеля — 2 кредита за запрос, календарь цен — 4 кредита за запрос.

Сводите публичные профили, контент и данные о вовлеченности с разных платформ в один рабочий процесс, чтобы отслеживать бренды, авторов и темы и эффективнее вести кросс-платформенный мониторинг и анализ.

Brand Monitoring API

Находите веб-страницы, где упоминается бренд, продукт или тема, оценивайте каждую по тональности и эмоциям и подводите итог тому, как о них говорят в интернете.

AI Search API

Отслеживайте, как AI Overviews, ChatGPT и Google AI Mode отвечают на вопросы вашего рынка: ответы, где назван ваш бренд, насколько вы заметны и какие домены и страницы цитируются.

Instagram API

Получайте или находите публичные профили и собирайте записи списков подписчиков, подписки, собственные публикации, публикации с отметкой профиля, результаты по хештегам, Reels, расшифровки, комментарии, счетчики аккаунтов, метрики вовлеченности и метаданные медиа в рамках одного асинхронного процесса.

TikTok API

Собирайте поддерживаемые публичные профили TikTok, метаданные видео по прямым ссылкам, комментарии верхнего уровня, результаты поиска видео и видео по заданным хештегам в едином нормализованном асинхронном процессе.

YouTube API

Собирайте поддерживаемые публичные профили каналов YouTube, данные о видео, видео каналов, комментарии, Shorts, результаты поиска по ключевым словам и хештегам и доступные расшифровки в едином нормализованном асинхронном процессе.

Facebook API

Собирайте публичные профили страниц Facebook, публикации, публикации в группах, комментарии, мероприятия по ключевому слову и доступные расшифровки видео с нормализованными полями идентичности, контента, источника, формата, места, медиа, реакций, посещаемости и вовлеченности.