Hotel Price Tracker
El calendario de precios de Google Hotels muestra, para un hotel, la tarifa más baja de una noche con entrada en cada fecha de las próximas semanas. Leídas como una serie temporal, estas tarifas por noche revelan la diferencia entre días de semana y fines de semana, los picos de temporada y el momento más barato para reservar, y sirven para seguir precios, revisar ingresos y planificar viajes.
Funcionalidades de la Hotel Price Tracker API
- El calendario en filasCada fila es una fecha de entrada; check_out es el día siguiente, y price.amount, price.currency y un precio con formato indican la tarifa más baja de esa noche.
- Varias semanas por consultaUna consulta suele cubrir de 6 a 8 semanas de fechas de entrada, sin tener que consultar cada fecha por separado.
- Fecha de inicio a eleccióncheck_in fija el inicio del calendario y se indica junto con check_out; si se omite, el calendario empieza mañana.
- Filas identificadas por hotel y fechaCada fila incluye hotel_id y name, e id combina el ID del hotel con la fecha de entrada, lo que facilita unir ejecuciones repetidas.
Parámetros de la Hotel Price Tracker 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 inicio del calendario (YYYY-MM-DD, hoy o posterior). Se indica junto con check_out; sin ambas fechas, el calendario empieza 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 las tarifas por noche, 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 resultados. El valor predeterminado es en. |
Cómo usar la Hotel Price Tracker API
Envíe un ID de hotel y lea una fila por fecha de entrada.
- Envíe {"hotel_id": "ChoIyKbJ6puqvPf8ARoNL2cvMTFqNHR2MjczeBAB", "currency": "USD"} por POST a /v1/google-hotels/hotel-prices.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea los precios por fecha en results.items y use results.next_cursor para obtener la siguiente página mientras has_more sea true.
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"}'Casos de uso de la Hotel Price Tracker API
- Encontrar la noche más barata: Ordene por price.amount y elija la fecha de entrada más barata de las próximas semanas para planificar su viaje.
- Días de semana frente a fin de semana: Agrupe por el día de la semana de check_in y calcule cuánto más cuestan las noches de viernes y sábado que las de entre semana.
- Seguimiento de cambios de precio: Obtenga el calendario de forma periódica, compare el precio de un mismo id entre ejecuciones y detecte cuándo un hotel sube o baja sus tarifas.
- Comparación con la competencia: Obtenga en la misma moneda los calendarios de varios hoteles cercanos y alinéelos por check_in para comparar la ventaja de precio noche a noche.
Consejos de expertos para la Hotel Price Tracker API
- Guarde las filas con el id que combina hotel y fecha de entrada: así, una ejecución diaria actualiza la misma noche en lugar de crear filas duplicadas.
- Para ver fechas más lejanas, mueva check_in hacia adelante y repita la solicitud.
- Mantenga la misma currency cuando compare varios hoteles o varias ejecuciones.
- Cada solicitud cuesta 4 créditos sin importar cuántas fechas devuelva, por lo que el calendario sale más barato que consultar fecha por fecha.
APIs relacionadas
Además de la Hotel Price Tracker 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.
- Google Hotel Details API — Abra la ficha de un hotel en Google Hotels con su ID y obtenga contacto, servicios, puntuación de la zona, distribución de calificaciones, temas de reseñas y ofertas por sitio de reserva.