Google Hotels reúne en una sola página las estrellas, las valoraciones de los huéspedes, los precios por noche y las ofertas de los sitios de reservas de un destino. Los productos de viajes, las herramientas de comparación de tarifas y los responsables de revenue management quieren esos datos en filas: una lista de hoteles para comparar, el registro completo de un establecimiento y cómo varía su precio según las fechas.
El 2026-11-17 SocQ lanzó la plataforma Google Hotels con tres endpoints que hacen exactamente eso. Se encadenan a través de un solo campo, el id del hotel. Esta guía cubre qué devuelve cada uno, la solicitud, el precio y cuándo usarlo.
Respuesta rápida: busque un destino con
POST /v1/google-hotels/searchy guarde elidde cada hotel. Páselo comohotel_idaPOST /v1/google-hotels/hotel-detailspara obtener servicios, temas de las reseñas y ofertas de los sitios de reservas, o aPOST /v1/google-hotels/hotel-pricespara obtener el precio más bajo por noche según la fecha de entrada. ConsulteGET /v1/tasks/{task_id}para ver los resultados.
Los nuevos endpoints de Google Hotels
1 crédito de SocQ = $0.005.
| Endpoint | Qué devuelve | Precio |
|---|---|---|
| Google Hotels API | Hoteles de un destino con estrellas, valoración de los huéspedes, número de reseñas, el precio más bajo por noche para sus fechas, ubicación, fotos y el id del hotel | 0.15 créditos ($0.00075) por hotel |
| Google Hotel Details API | Dirección, teléfono, sitio web, servicios, puntuaciones de ubicación, distribución de valoraciones, temas de las reseñas, valoraciones en otros sitios y la oferta de cada sitio de reservas de un hotel | 2 créditos ($0.01) por llamada |
| Hotel Price Tracker API | Una fila por fecha de entrada con el precio más bajo del hotel para una noche, normalmente de seis a ocho semanas de fechas | 4 créditos ($0.02) por llamada |
Autenticación y flujo de tareas asíncronas
Todas las solicitudes a SocQ se autentican con una clave de API, y se usa el mismo encabezado para el envío, el estado de la tarea y las solicitudes de resultados:
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Cada recopilación se ejecuta como una tarea en segundo plano:
submit -> task_id -> queued -> running -> succeeded
\-> failed
La respuesta del envío contiene data.task_id y data.status. Consulte la tarea con ese ID:
curl "https://api.socq.ai/v1/tasks/$TASK_ID?limit=50" \
-H "Authorization: Bearer $SOCQ_API_KEY"
Cuando status es succeeded, la respuesta incluye la primera página de registros normalizados en data.results.items. limit vale 50 por defecto y admite hasta 500; si has_more es verdadero, pase results.next_cursor como cursor para leer la página siguiente. Mientras una tarea está en queued, running o failed, el endpoint devuelve los metadatos de la tarea sin results.
Un callback_url opcional en el cuerpo del envío hace que SocQ envíe un POST con un resumen de la tarea cuando esta termina; lea los registros con GET /v1/tasks/{task_id}. Un tiempo de espera agotado en el cliente no cancela la tarea, así que retome con el mismo ID de tarea en lugar de pagar por un duplicado. 402 significa créditos insuficientes; 429 significa que la clave alcanzó un límite de solicitudes o de créditos.
Google Hotels API: buscar un destino
La Google Hotels API busca hoteles como lo hacen los viajeros en Google. Indique en query un destino o una búsqueda de hotel.
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
}'
Campos opcionales:
check_inycheck_out(YYYY-MM-DD, indicados juntos, hasta 30 noches) cotizan una estancia concreta. Sin ellos, los precios corresponden a una noche a partir de mañana.currency: un código de tres letras comoUSDoEUR.sort_by:relevance,lowest_price,highest_ratingomost_reviewed.min_priceymax_price: el rango de precio por noche, en la moneda elegida.location_code(por defecto 2840, Estados Unidos) ylanguage_code(por defectoen).results_limit: de 1 a 140, por defecto 18.
Cada fila de hotel tiene id, name, stars (de 1 a 5), rating (de 1 a 5), reviews_count, price (amount, currency, formatted), los check_in y check_out a los que corresponde el precio, is_sponsored, location con latitud y longitud, images y rank en los resultados. Los 18 hoteles por defecto cuestan 2.7 créditos ($0.0135); el máximo de 140 cuesta 21 créditos ($0.105). Documentación: búsqueda de Google Hotels.
Google Hotel Details API: todo sobre un establecimiento
La Google Hotel Details API devuelve una fila con lo que Google Hotels sabe de un establecimiento. Pase el id de un resultado de búsqueda como hotel_id. Añada check_in y check_out para obtener ofertas para esas fechas; de lo contrario, las ofertas corresponden a una noche a partir de mañana.
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"
}'
Además de los campos de la búsqueda, la fila de detalles incluye:
address,phone,website,check_in_time,check_out_timeyamenities.location_scoresde 1 a 5 paraoverall,things_to_do,restaurants,transityairport_access.rating_distribution, la proporción de reseñas en cada número de estrellas.review_topics, como Location o Breakfast, con el número de menciones positivas, negativas y totales.other_reviews, la valoración y el número de reseñas del hotel en otros sitios de reseñas.offers, una por sitio de reservas, conseller,price,urlde reserva,is_official,is_sponsoredyfree_cancellation_until.
offers es lo que necesitan las comprobaciones de paridad de tarifas: compare la oferta oficial con las agencias de viajes en línea para las mismas fechas. Cada solicitud cuesta 2 créditos ($0.01). Un hotel_id desconocido no devuelve filas y se cobra igualmente. Documentación: Google Hotel Details.
Hotel Price Tracker API: precio más bajo por fecha de entrada
La Hotel Price Tracker API devuelve en filas el calendario de precios que hay detrás del selector de fechas de Google Hotels. Para un hotel obtiene el precio más bajo de cada noche de entrada, normalmente de seis a ocho semanas de fechas a partir de su fecha de entrada.
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 fija la primera fecha del calendario (mañana si se omite); indique check_out junto con él. Cada fila tiene un id formado por el ID del hotel y la fecha, hotel_id, name, check_in, check_out y price. Úselo para detectar las noches más baratas para viajar, comparar en un gráfico los precios de fin de semana frente a los de entre semana o alimentar un informe de comparación de tarifas. Cada solicitud cuesta 4 créditos ($0.02), sin importar el número de fechas. Documentación: Hotel Price Tracker.
Un flujo sencillo para un conjunto competitivo
- Busque el destino una vez con
sort_by: "most_reviewed"y elija su conjunto competitivo entre los resultados. - Obtenga Hotel Details de cada hotel para comparar servicios, puntuaciones de ubicación, temas de las reseñas y ofertas de los sitios de reservas.
- Ejecute Hotel Price Tracker para cada hotel de forma programada y guarde cada fila con su
collected_at.
Para un conjunto de 10 hoteles elegidos de una búsqueda por defecto de 18 hoteles, una ejecución supone 2.7 créditos de la búsqueda, 20 créditos de los detalles y 40 créditos de los calendarios de precios: 62.7 créditos, unos $0.31. Los precios cambian, así que trate cada ejecución como una instantánea. Para datos de negocios locales, como lugares y reseñas en Google Maps, consulte las APIs de scraping de Google Maps.
Preguntas frecuentes
¿Qué es la Google Hotels API?
Un conjunto de endpoints de SocQ que devuelven datos de Google Hotels como filas estructuradas: resultados de búsqueda de un destino, detalles completos de un hotel y un calendario de precios por noche. Son endpoints de SocQ, no un producto oficial de Google.
¿De dónde obtengo un hotel_id?
Del campo id de los resultados de búsqueda de Google Hotels. El mismo valor sirve para Hotel Details y Hotel Price Tracker.
¿A qué fechas corresponden los precios?
Si envía check_in y check_out (YYYY-MM-DD, hasta 30 noches), los precios corresponden a esa estancia. Sin ellos, la búsqueda y los detalles cotizan una noche a partir de mañana, y el rastreador de precios empieza su calendario mañana.
¿Puedo obtener precios en otra moneda?
Sí. Envíe una currency de tres letras como EUR. Cada objeto de precio incluye amount, currency y una cadena formatted como USD 176.
¿Se me cobra por un hotel_id no válido?
Sí. Hotel Details no devuelve filas para un hotel_id desconocido y se cobran igualmente 2 créditos, así que valide los IDs con una búsqueda reciente primero.
GOOGLE HOTELS API
Probar el flujo de trabajo con una URL pública de Google Hotels
Envíe entradas públicas y reciba registros normalizados con contexto de origen rastreable.
Ver las API de Google Hotels