Google Hotels
Un resultado de búsqueda en Google Hotels reúne el nombre, la categoría y la ubicación de un hotel con la calificación de los huéspedes, el número de reseñas, fotos y la tarifa por noche más baja para las fechas y la moneda elegidas. Puestos lado a lado, estos datos muestran cómo cambia la oferta hotelera entre destinos, cómo se equilibran precio y calificación y qué hoteles merecen una revisión más detallada.
Funcionalidades de la Google Hotels API
- Buscar como lo hace un viajeroquery acepta destinos como hotels in new york o el nombre de un hotel; los hoteles llegan en el orden en que los muestra Google Hotels y rank indica la posición de cada uno.
- Precios para una estadía realcheck_in, check_out y currency definen la estadía que le interesa; cada fila incluye esas fechas junto con price.amount, price.currency y un precio con formato.
- Orden y rango de preciossort_by cambia entre relevance, lowest_price, highest_rating y most_reviewed, y min_price y max_price dejan solo los hoteles que entran en su presupuesto.
- Indicadores de calidad en cada hotelstars es la categoría del hotel, rating la calificación media de los huéspedes de 1 a 5 y reviews_count el número de reseñas que la respaldan.
- Coordenadas y fotoslocation trae la latitud y la longitud, e images las fotos que Google muestra del hotel.
- ID de hotel para seguir consultandoEl id de cada fila se pasa tal cual a Google Hotel Details API y a Hotel Price Tracker API, y url apunta a la página del hotel en Google Hotels.
- Hasta 140 hoteles por consultaresults_limit va de 1 a 140, e is_sponsored separa los anuncios pagados de los resultados normales.
Parámetros de la Google Hotels API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
query | Obligatorio | Búsqueda de destino u hotel, por ejemplo hotels in new york o el nombre de un hotel. |
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 y el rango de precios, por ejemplo USD o EUR. |
sort_by | Opcional | Orden: relevance, lowest_price, highest_rating o most_reviewed. |
min_price | Opcional | Precio mínimo por noche, en la moneda de currency. |
max_price | Opcional | Precio máximo por noche, en la moneda de currency. No puede ser menor que min_price. |
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. |
results_limit | Opcional | Número de hoteles que se devuelven (1–140). El valor predeterminado es 18. |
Cómo usar la Google Hotels API
Busque un destino y lea los hoteles fila por fila.
- Envíe {"query": "hotels in new york", "currency": "USD", "results_limit": 18} por POST a /v1/google-hotels/search.
- Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
- Lea los hoteles 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/search" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"query":"hotels in new york","currency":"USD","results_limit":18}'Casos de uso de la Google Hotels API
- Nivel de precios de un destino: Ponga price.amount junto a stars y rating para las mismas fechas y ubique los precios hoteleros de una ciudad según su categoría.
- Preselección de hoteles: Conserve los hoteles de su rango de precios cuyo rating y reviews_count superen su umbral y pase su id a las consultas de detalles y de precios.
- Comparar fechas de viaje: Ejecute la misma query cambiando check_in y check_out y una los resultados por id para ver cómo varían los precios entre fechas.
- Mapa de la oferta hotelera: Superponga stars y precios sobre las coordenadas de location para ver dónde se concentran los hoteles económicos y los de lujo en una zona.
Consejos de expertos para la Google Hotels API
- Indique siempre currency en las búsquedas que vaya a comparar, para que price.amount esté en la misma unidad.
- Envíe check_in y check_out siempre juntos. Las estadías de más de 30 noches o con salida antes de la entrada se rechazan antes de crear la tarea.
- Una las consultas posteriores por id y no por nombre: los hoteles de una misma cadena en una ciudad suelen tener nombres casi iguales.
- Cada hotel devuelto cuesta 0.15 créditos, así que ajuste results_limit a la cantidad que realmente vaya a revisar.
APIs relacionadas
Además de la Google Hotels API, use estas APIs cuando necesite otro tipo de datos públicos de Google Hotels.
- 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.
- 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.