Volver a las API
Datos de Google Hotels

Google Hotels Data APIs

Busque hoteles por destino, abra la ficha completa de cualquier hotel en Google Hotels y obtenga su calendario de precios por noche, todo conectado por un mismo ID de hotel.

API de Google Hotels disponibles

Empiece con Google Hotels API para encontrar hoteles y sus ID, y luego use Google Hotel Details API para la ficha y las ofertas de un hotel, o Hotel Price Tracker API para sus precios por fecha de entrada.

¿Qué datos de Google Hotels se pueden obtener?

Cada fila describe un hotel o una noche, con precios en la moneda elegida y un ID de hotel que conecta las tres API.

Listas de hoteles con precios

Nombre, posición, tarifa por noche más baja para sus fechas, indicador de anuncio pagado y enlace a la página del hotel en Google Hotels.

Calificaciones y reseñas de huéspedes

Estrellas, calificación media de 1 a 5, número de reseñas, proporción de cada calificación en estrellas y menciones positivas y negativas por tema.

Ofertas por sitio de reserva

Precio por noche y enlace de reserva de cada vendedor, con indicación del sitio oficial, las ofertas pagadas y la cancelación gratuita.

Ubicación y barrio

Dirección, coordenadas, nombre del barrio y puntuaciones de 1 a 5 para actividades, restaurantes, transporte y acceso al aeropuerto.

Calendario de precios por noche

La tarifa más baja de cada fecha de entrada de un hotel, normalmente para las próximas 6 a 8 semanas.

Qué API de Google Hotels usar

Las tres API comparten el mismo ID de hotel, así que un resultado de búsqueda pasa directamente a una consulta de ficha o de calendario.

APIPunto de partidaQué obtiene
Google Hotels APIUn destino o nombre de hotel en queryHasta 140 hoteles con tarifa por noche, estrellas, calificación, número de reseñas, coordenadas e ID
Google Hotel Details APIUn hotel_idUna fila con contacto, servicios, puntuación de la zona, distribución de calificaciones, temas de reseñas y ofertas por sitio
Hotel Price Tracker APIUn hotel_idUna fila por fecha de entrada con la tarifa más baja de esa noche, normalmente para 6 a 8 semanas

Cómo funciona la API de Google Hotels

Las tres API usan el mismo flujo de tareas asíncronas.

  1. 1. Buscar hoteles

    Envíe un destino por POST a /v1/google-hotels/search y guarde el id de los hoteles que quiera seguir.

  2. 2. Profundizar

    Envíe un hotel_id a /v1/google-hotels/hotel-details para la ficha y las ofertas, o a /v1/google-hotels/hotel-prices para el calendario de precios.

  3. 3. Leer los resultados

    Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y lea las filas de results.items.

Buscar hoteles en un destino

Autentíquese con su clave de API de SocQ y envíe un destino. Cada hotel devuelto cuesta 0.15 créditos.

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

Casos de uso frecuentes de la API de Google Hotels

Referencias de precios por destino

Compare tarifas por noche según estrellas y calificación entre ciudades para las mismas fechas.

Revisión de paridad de tarifas

Compare la tarifa oficial de un hotel con las ofertas de las agencias de viajes en línea para la misma estadía.

Seguimiento de la competencia

Siga lado a lado los calendarios de precios, la distribución de calificaciones y los temas de reseñas de hoteles cercanos.

Contenido de viajes y fichas de hotel

Complete las fichas con dirección, servicios, horarios de entrada, fotos y puntuación de la zona.

Planificación de viajes

Encuentre las fechas de entrada más baratas de las próximas semanas antes de reservar.

Reglas de solicitud y precios

Estas reglas se aplican a las tres API de Google Hotels.

  • Envíe check_in y check_out juntos, en formato YYYY-MM-DD desde hoy, para una estadía de hasta 30 noches; sin ellas, los precios corresponden a una noche a partir de mañana.
  • Indique currency con un código de tres letras como USD o EUR para que los precios sean comparables entre solicitudes.
  • Google Hotels API devuelve de 1 a 140 hoteles por solicitud, 18 por defecto, y cuesta 0.15 créditos por hotel devuelto.
  • Google Hotel Details API usa un hotel_id de un resultado de búsqueda y cuesta 2 créditos por solicitud.
  • Hotel Price Tracker API usa un hotel_id y cuesta 4 créditos por solicitud por el calendario completo.

Preguntas frecuentes sobre la API de Google Hotels

¿Qué es Google Hotels API?

Google Hotels API busca hoteles en Google Hotels por destino y devuelve sus tarifas por noche para sus fechas, estrellas, calificación de huéspedes, número de reseñas, coordenadas y un ID de hotel para consultas posteriores.

¿Qué API de Google Hotels están disponibles?

Google Hotels API para la búsqueda, Google Hotel Details API para la ficha y las ofertas por sitio de un hotel, y Hotel Price Tracker API para sus precios por fecha de entrada.

¿De dónde sale el hotel_id?

Cada fila de Google Hotels API incluye el ID del hotel en el campo id. Envíe ese valor como hotel_id a las API de ficha y de calendario.

¿A qué fechas corresponden los precios?

La búsqueda y la ficha usan sus fechas check_in y check_out, hasta 30 noches, o una noche a partir de mañana si se omiten. El calendario muestra una noche por fecha de entrada durante unas 6 a 8 semanas.

¿Cómo se cobran las solicitudes de Google Hotels?

La búsqueda cuesta 0.15 créditos por hotel devuelto, la ficha del hotel 2 créditos por solicitud y el calendario de precios 4 créditos por solicitud.

Reúna en un mismo flujo de trabajo perfiles públicos, contenido y datos de interacción de distintas plataformas para dar seguimiento a marcas, creadores y temas, y para realizar monitoreo y análisis entre plataformas con más eficiencia.

Brand Monitoring API

Encuentre las páginas web que mencionan una marca, un producto o un tema, puntúe cada una por sentimiento y emoción, y resuma cómo habla la web de ello.

AI Search API

Siga cómo AI Overviews, ChatGPT y Google AI Mode responden a las preguntas de su mercado: las respuestas que nombran su marca, qué tan visible es y qué dominios y páginas citan.

Instagram API

Consulte o encuentre perfiles públicos y obtenga registros de listas de seguidores, relaciones de seguidos, publicaciones propias, publicaciones que etiquetan un perfil, resultados por hashtag, Reels, transcripciones, comentarios, conteos de cuentas, métricas de interacción y metadatos multimedia con un único flujo asíncrono.

TikTok API

Recopile perfiles públicos de TikTok compatibles, metadatos de videos directos, comentarios de primer nivel, resultados de búsqueda de videos y videos de hashtags específicos con un único flujo asíncrono normalizado.

YouTube API

Recopile perfiles públicos compatibles de canales de YouTube, detalles de videos, videos de canales, comentarios, Shorts, resultados por palabra clave y hashtag, y transcripciones disponibles con un único flujo asíncrono normalizado.

Facebook API

Obtenga perfiles públicos de páginas de Facebook, publicaciones, publicaciones de grupos, comentarios, eventos que coinciden con una palabra clave y transcripciones de video disponibles, con campos normalizados de identidad, contenido, origen, formato, lugar, contenido multimedia, reacciones, asistencia e interacción.