Google HotelsPrecios de hotelesDatos de viajesComparación de tarifasGuía de API

API de Google Hotels: búsqueda de hoteles, detalles de hoteles y calendarios de precios por noche

Tres nuevos endpoints de Google Hotels en SocQ devuelven resultados de búsqueda de hoteles con precios, los detalles completos de un hotel con las ofertas de cada sitio de reservas y el precio más bajo por noche según la fecha de entrada.

SocQActualizado el 19 de noviembre de 20268 min de lectura

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/search y guarde el id de cada hotel. Páselo como hotel_id a POST /v1/google-hotels/hotel-details para obtener servicios, temas de las reseñas y ofertas de los sitios de reservas, o a POST /v1/google-hotels/hotel-prices para obtener el precio más bajo por noche según la fecha de entrada. Consulte GET /v1/tasks/{task_id} para ver los resultados.

Los nuevos endpoints de Google Hotels

1 crédito de SocQ = $0.005.

EndpointQué devuelvePrecio
Google Hotels APIHoteles 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 hotel0.15 créditos ($0.00075) por hotel
Google Hotel Details APIDirecció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 hotel2 créditos ($0.01) por llamada
Hotel Price Tracker APIUna fila por fecha de entrada con el precio más bajo del hotel para una noche, normalmente de seis a ocho semanas de fechas4 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_in y check_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 como USD o EUR.
  • sort_by: relevance, lowest_price, highest_rating o most_reviewed.
  • min_price y max_price: el rango de precio por noche, en la moneda elegida.
  • location_code (por defecto 2840, Estados Unidos) y language_code (por defecto en).
  • 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_time y amenities.
  • location_scores de 1 a 5 para overall, things_to_do, restaurants, transit y airport_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, con seller, price, url de reserva, is_official, is_sponsored y free_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

  1. Busque el destino una vez con sort_by: "most_reviewed" y elija su conjunto competitivo entre los resultados.
  2. 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.
  3. 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