google-hotels/
search

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 y un ID para consultas posteriores.

Google Hotels API

Búsqueda por destino
Precios para sus fechas
Estrellas y calificación
ID de hotel reutilizable
0.15 créditos por resultado
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 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ámetrosObligatorioDescripción
queryObligatorioBúsqueda de destino u hotel, por ejemplo hotels in new york o el nombre de un hotel.
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 y el rango de precios, por ejemplo USD o EUR.
sort_byOpcionalOrden: relevance, lowest_price, highest_rating o most_reviewed.
min_priceOpcionalPrecio mínimo por noche, en la moneda de currency.
max_priceOpcionalPrecio máximo por noche, en la moneda de currency. No puede ser menor que min_price.
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 resultados. El valor predeterminado es en.
results_limitOpcionalNú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.

  1. Envíe {"query": "hotels in new york", "currency": "USD", "results_limit": 18} por POST a /v1/google-hotels/search.
  2. Consulte GET /v1/tasks/{task_id} hasta que status sea succeeded.
  3. 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.

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.

Explorar otras plataformas

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

Google Hotels API — FAQ

Google Hotels API busca hoteles en Google Hotels por destino o nombre y devuelve de cada uno la tarifa por noche para sus fechas, estrellas, calificación de huéspedes, número de reseñas, coordenadas, fotos y un ID de hotel.

A las fechas check_in y check_out que indique, con un máximo de 30 noches. Sin ambas fechas, los precios corresponden a una noche a partir de mañana; cada fila incluye las fechas de su precio.

Sí. min_price y max_price limitan el precio por noche, y sort_by ordena por relevance, lowest_price, highest_rating o most_reviewed.

La búsqueda devuelve campos de nivel de lista. Pase el id de un hotel a Google Hotel Details API para obtener dirección, servicios, temas de reseñas y precios por sitio de reserva, o a Hotel Price Tracker API para los precios por fecha de entrada.

0.15 créditos por hotel devuelto, es decir, 2.7 créditos por 18 hoteles. Las búsquedas que no encuentran hoteles no se cobran.