google-hotels/
hotel-details

Obtenga con un ID de hotel su ficha completa en Google Hotels: contacto, servicios, puntuación de la zona, distribución de calificaciones, temas de reseñas y el precio de cada sitio de reserva.

Google Hotel Details API

Precios por sitio de reserva
Temas de reseñas
Distribución de calificaciones
Puntuación de la zona
2 créditos por solicitud
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

Google Hotel Details

La ficha de un hotel en Google Hotels reúne dirección, teléfono, horarios de entrada y servicios con lo que dicen los huéspedes: la proporción de cada calificación en estrellas, las menciones positivas y negativas sobre temas como la ubicación o el desayuno, y las calificaciones de otros sitios de reseñas. Junto con los precios que cada sitio de reserva y el sitio oficial del hotel ofrecen para la misma estadía, sirve para revisar la paridad de tarifas, compararse con la competencia y completar fichas de hotel.

Funcionalidades de la Google Hotel Details API

  • Precios por sitio de reservaoffers incluye el precio por noche y el enlace de reserva de cada vendedor; is_official, is_sponsored y free_cancellation_until identifican la tarifa directa, los anuncios pagados y las tarifas con cancelación gratuita.
  • De qué hablan los huéspedesreview_topics devuelve positive_count, negative_count y mentions_count para temas como Wellness o Breakfast y muestra qué partes de la estadía reciben elogios o críticas.
  • Distribución de calificaciones y otros sitiosrating_distribution indica la proporción de cada calificación en estrellas, y other_reviews la calificación, el número de reseñas y un extracto de sitios como Tripadvisor.
  • Puntuación de la zonalocation_scores califica de 1 a 5 la ubicación general, las actividades, los restaurantes, el transporte y el acceso al aeropuerto, junto con el nombre del barrio y las coordenadas.
  • Los datos del hotel en una filaaddress, phone, website, check_in_time, check_out_time, los servicios disponibles, una descripción y fotos llegan juntos.
  • Precios para sus fechascheck_in, check_out y currency fijan la estadía a la que corresponden los precios; sin fechas, se usa una noche a partir de mañana.

Parámetros de la Google Hotel Details API

ParámetrosObligatorioDescripción
hotel_idObligatorioID de hotel tomado del campo id de un resultado de Google Hotels API.
check_inOpcionalFecha de entrada (YYYY-MM-DD, hoy o posterior). Se indica junto con check_out; sin ambas fechas, los precios corresponden a una noche a partir de mañana.
check_outOpcionalFecha de salida (YYYY-MM-DD). Debe ser posterior a check_in; máximo 30 noches.
currencyOpcionalCódigo de moneda de tres letras para los precios, por ejemplo USD o EUR.
location_codeOpcionalCódigo de ubicación del mercado de búsqueda. El valor predeterminado es 2840 (Estados Unidos).
language_codeOpcionalCódigo de idioma de los detalles del hotel. El valor predeterminado es en.

Cómo usar la Google Hotel Details API

Envíe un ID obtenido en la búsqueda de hoteles y lea el hotel en una sola fila.

  1. Envíe {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} por POST a /v1/google-hotels/hotel-details.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. Lea el hotel en results.items. has_more y results.next_cursor siguen las reglas de paginación habituales y quedan vacíos en este resultado de una sola fila.
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"}'

Casos de uso de la Google Hotel Details API

  • Revisión de paridad de tarifas: Compare la tarifa directa marcada con is_official con los precios de las agencias de viajes en línea para las mismas fechas y detecte los vendedores que ofrecen el hotel más barato.
  • Comparación con la competencia: Ponga lado a lado rating_distribution, review_topics y location_scores de hoteles cercanos para ver en qué destaca cada uno y en qué se queda atrás.
  • Fichas de hotel completas: Obtenga en una sola consulta dirección, servicios, horarios de entrada, fotos y puntuación de la zona para completar las fichas de hotel de un servicio de viajes.
  • Análisis de la opinión de los huéspedes: Ordene review_topics por negative_count para encontrar los temas con más quejas, como el ruido o el desayuno.

Consejos de expertos para la Google Hotel Details API

  • Use IDs de una búsqueda reciente con Google Hotels API, para que cada solicitud de 2 créditos devuelva el hotel esperado.
  • Repita los mismos check_in, check_out y currency de la búsqueda para que los precios de los vendedores coincidan con el precio de la lista.
  • Descarte los anuncios pagados con is_sponsored antes de comparar vendedores, para que la comparación sea equilibrada.
  • Trate rating_distribution.share como una proporción entre 0 y 1 al graficar la distribución de calificaciones.

Además de la Google Hotel Details API, use estas APIs cuando necesite otro tipo de datos públicos de Google Hotels.

  • Google Hotels API — Busque hoteles en Google Hotels por destino y obtenga de cada uno la tarifa por noche para sus fechas, estrellas, calificación de huéspedes, número de reseñas, coordenadas e ID.
  • Hotel Price Tracker API — Obtenga con un ID de hotel su calendario de precios en Google Hotels, con la tarifa por noche más baja de cada fecha de entrada durante unas 6 a 8 semanas.

Explorar otras plataformas

Combine los datos de Google Hotels con datos públicos de otras plataformas sociales compatibles.

Google Hotel Details API — FAQ

Google Hotel Details API obtiene con un ID de hotel su ficha en Google Hotels y devuelve contacto, servicios, puntuación de la zona, distribución de calificaciones, temas de reseñas, calificaciones de otros sitios y el precio de cada sitio de reserva.

Cada fila que devuelve Google Hotels API incluye el ID del hotel en el campo id; ese es el valor que debe enviar en hotel_id.

Los sitios de reserva que Google Hotels muestra para la estadía. Cuando participa el sitio oficial del hotel, también aparece y se marca con is_official.

rating_distribution muestra la proporción de cada calificación en estrellas, review_topics las menciones positivas y negativas por tema, y other_reviews añade calificaciones y extractos de sitios de reseñas externos.

Cada solicitud cuesta 2 créditos y devuelve el hotel que corresponde al hotel_id enviado.