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ámetros | Obligatorio | Descripción |
|---|---|---|
hotel_id | Obligatorio | ID de hotel tomado del campo id de un resultado de Google Hotels API. |
check_in | Opcional | Fecha 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_out | Opcional | Fecha de salida (YYYY-MM-DD). Debe ser posterior a check_in; máximo 30 noches. |
currency | Opcional | Código de moneda de tres letras para los precios, por ejemplo USD o EUR. |
location_code | Opcional | Código de ubicación del mercado de búsqueda. El valor predeterminado es 2840 (Estados Unidos). |
language_code | Opcional | Có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.
- Envíe {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} por POST a /v1/google-hotels/hotel-details.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- 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.
APIs relacionadas
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.