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.
| API | Punto de partida | Qué obtiene |
|---|---|---|
| Google Hotels API | Un destino o nombre de hotel en query | Hasta 140 hoteles con tarifa por noche, estrellas, calificación, número de reseñas, coordenadas e ID |
| Google Hotel Details API | Un hotel_id | Una fila con contacto, servicios, puntuación de la zona, distribución de calificaciones, temas de reseñas y ofertas por sitio |
| Hotel Price Tracker API | Un hotel_id | Una 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. Buscar hoteles
Envíe un destino por POST a /v1/google-hotels/search y guarde el id de los hoteles que quiera seguir.
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. Leer los resultados
Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded y lea las filas de results.items.
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.itemsCasos 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.
Combine datos de varias plataformas para obtener información de negocio más completa
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.


