Google Hotels Pesquisar API

prod-global

GET

/api/v1/google/hotels/search

Status de saúde da API

Saudável Disponível Limitado Quase indisponível Sem dados

Carregando status...

Obtenha dados de pesquisa de hotéis do Google, incluindo preços, avaliações e detalhes de disponibilidade, para comparação de viagens e análise do mercado de hospitalidade.

Tags: Google Hotels

Parâmetros

Nome	Obrigatório	Tipo	Padrão	Descrição
query	Sim	string		O destino ou nome específico do hotel que você está pesquisando (ex.: 'Paris', 'Hilton New York').
check_in_date	Sim	string		A data de check-in do hotel no formato 'YYYY-MM-DD' (ex.: '2026-05-20').
check_out_date	Sim	string		A data de check-out do hotel no formato 'YYYY-MM-DD' (ex.: '2026-05-25').
next_page_token	Não	string		O token usado para recuperar a próxima página de resultados de hotéis. Este token é encontrado no campo 'next_page_token' de uma resposta anterior.
adults	Não	integer	2	O número de adultos hospedados no quarto.
children	Não	integer	0	O número de crianças hospedadas no quarto.
children_ages	Não	string		As idades das crianças, separadas por vírgulas (ex.: '5,10'). O número de idades deve corresponder ao parâmetro 'children'.
html	Não	boolean	false	Defina como true para retornar o HTML bruto da página de resultados de pesquisa do Google junto com os dados estruturados.
language	Não	string	en	Defina o idioma dos resultados usando seu código de duas letras (ex.: 'en' para inglês, 'fr' para francês). Veja Idioma do Google.
country	Não	string	us	Defina o código do país de destino (ex.: 'us', 'uk') para localizar os resultados. Veja Países do Google.
currency	Não	string	USD	O código de moeda ISO de três letras para exibir preços (ex.: 'USD', 'EUR'). Veja Google Hotels Currency.
sort_by	Não	string		Os critérios para ordenar os resultados de hotéis. Valores disponíveis: - LOWEST_PRICE: Menor preço. O valor legado 3 também é aceito. - HIGHEST_RATING: Maior avaliação. O valor legado 8 também é aceito. - MOST_REVIEWS: Mais avaliações. O valor legado 13 também é aceito.
min_price	Não	string		Filtro de preço mínimo para a estadia no hotel.
max_price	Não	string		Filtro de preço máximo para a estadia no hotel.
property_types	Não	string		Filtrar por tipos de propriedade de hotel. Veja a Google Property Types para a lista completa de tipos de propriedade de hotel suportados. Para aluguéis de temporada, consulte a Google Hotels Vacation Rentals Property Types.
amenities	Não	string		Filtrar por comodidades específicas (ex.: '35' para Wi-Fi gratuito). Google Hotels Amenities (comodidades de hotel). Google Hotels Vacation Rentals Amenities (comodidades de aluguel de temporada)
rating	Não	string		Filtrar por avaliação mínima do hóspede. Valores disponíveis: - AT_LEAST_3_5: Avaliação do hóspede 3.5+. O valor legado 7 também é aceito. - AT_LEAST_4_0: Avaliação do hóspede 4.0+. O valor legado 8 também é aceito. - AT_LEAST_4_5: Avaliação do hóspede 4.5+. O valor legado 9 também é aceito.
brands	Não	string		Filtrar por IDs de marcas de hotel específicas. Os IDs podem ser separados por vírgula.
hotel_class	Não	string		Filtrar por classificação de estrelas do hotel. Valores suportados: '2', '3', '4', '5'. Pode ser separado por vírgulas.
free_cancellation	Não	string		Filtrar por hotéis que oferecem cancelamento gratuito. Defina como '1' ou 'true' para ativar.
special_offers	Não	string		Filtrar por hotéis que oferecem ofertas especiais ou descontos atualmente. Defina como '1' ou 'true' para ativar.
eco_certified	Não	string		Filtrar por hotéis com certificação ecológica. Defina como '1' ou 'true' para ativar.
vacation_rentals	Não	boolean	false	Defina como true para pesquisar por aluguéis de temporada em vez de hotéis padrão.
bedrooms	Não	string		Número mínimo de quartos necessário (aplica-se a aluguéis de temporada).
bathrooms	Não	string		Número mínimo de banheiros necessário (aplica-se a aluguéis de temporada).
property_token	Não	string		O token único para uma propriedade de hotel específica para buscar informações detalhadas.

Copiar requisição

cURL

curl -X GET "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE" \
  -H "X-API-Key: YOUR_API_KEY"

JavaScript

const res = await fetch("https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE", {
  headers: { "X-API-Key": "YOUR_API_KEY" }
});
const data = await res.json();
console.log(data);

Python

import requests

url = "https://api.justserpapi.com/api/v1/google/hotels/search"
headers = { "X-API-Key": "YOUR_API_KEY" }
params = {
  "query": "coffee",
  "check_in_date": "YOUR_VALUE",
  "check_out_date": "YOUR_VALUE"
}
response = requests.get(url, headers=headers, params=params)
print(response.json())

PHP

<?php
$url = "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE";
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "X-API-Key: YOUR_API_KEY"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

Go

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	client := &http.Client{}
	req, _ := http.NewRequest("GET", "https://api.justserpapi.com/api/v1/google/hotels/search?query=coffee&check_in_date=YOUR_VALUE&check_out_date=YOUR_VALUE", nil)
	req.Header.Set("X-API-Key", "YOUR_API_KEY")
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

Resposta

Carregando o exemplo de resposta mais recente...