Google Hotels Поиск API

prod-global

GET

/api/v1/google/hotels/search

Статус API

Исправен Доступен Ограничен Почти недоступен Нет данных

Загрузка статуса...

Получите данные поиска отелей Google, включая цены, рейтинги и информацию о наличии, для сравнения путешествий и анализа рынка гостиничного бизнеса.

Теги: Google Hotels

Параметры

Имя	Обязательный	Тип	По умолчанию	Описание
query	Да	string		Название пункта назначения или конкретного отеля, которое вы ищете (например, 'Париж', 'Hilton New York').
check_in_date	Да	string		Дата заезда в отель в формате 'ГГГГ-ММ-ДД' (например, '2026-05-20').
check_out_date	Да	string		Дата выезда из отеля в формате 'ГГГГ-ММ-ДД' (например, '2026-05-25').
next_page_token	Нет	string		Токен для получения следующей страницы результатов поиска отелей. Этот токен находится в поле 'next_page_token' предыдущего ответа.
adults	Нет	integer	2	Количество взрослых, проживающих в номере.
children	Нет	integer	0	Количество детей, проживающих в номере.
children_ages	Нет	string		Возраст детей, разделенный запятыми (например, '5,10'). Количество возрастов должно соответствовать параметру 'children'.
html	Нет	boolean	false	Установите значение true, чтобы вернуть необработанный HTML страницы результатов поиска Google вместе со структурированными данными.
language	Нет	string	en	Установите язык результатов, используя его двухбуквенный код (например, 'en' для английского, 'fr' для французского). См. Google Language.
country	Нет	string	us	Установите код целевой страны (например, 'us', 'uk') для локализации результатов. См. Google Countries.
currency	Нет	string	USD	Трехбуквенный код валюты ISO для отображения цен (например, 'USD', 'EUR'). См. Google Hotels Currency.
sort_by	Нет	string		Критерии сортировки результатов поиска отелей. Доступные значения: - LOWEST_PRICE: Самая низкая цена. Также принимается устаревшее значение 3. - HIGHEST_RATING: Самый высокий рейтинг. Также принимается устаревшее значение 8. - MOST_REVIEWS: Больше всего отзывов. Также принимается устаревшее значение 13.
min_price	Нет	string		Фильтр минимальной цены за проживание в отеле.
max_price	Нет	string		Фильтр максимальной цены за проживание в отеле.
property_types	Нет	string		Фильтр по типам объектов размещения. См. Google Property Types для полного списка поддерживаемых типов объектов размещения. Для аренды отпускного жилья обратитесь к Google Hotels Vacation Rentals Property Types.
amenities	Нет	string		Фильтр по конкретным удобствам (например, '35' для бесплатного Wi-Fi). Google Hotels Amenities (удобства отеля). Google Hotels Vacation Rentals Amenities (удобства аренды отпускного жилья)
rating	Нет	string		Фильтр по минимальному рейтингу гостей. Доступные значения: - AT_LEAST_3_5: Рейтинг гостей 3.5+. Также принимается устаревшее значение 7. - AT_LEAST_4_0: Рейтинг гостей 4.0+. Также принимается устаревшее значение 8. - AT_LEAST_4_5: Рейтинг гостей 4.5+. Также принимается устаревшее значение 9.
brands	Нет	string		Фильтр по конкретным идентификаторам брендов отелей. Идентификаторы можно указывать через запятую.
hotel_class	Нет	string		Фильтр по рейтингу отелей в звездах. Поддерживаемые значения: '2', '3', '4', '5'. Можно указывать через запятую.
free_cancellation	Нет	string		Фильтр для отелей с бесплатной отменой бронирования. Установите '1' или 'true' для включения.
special_offers	Нет	string		Фильтр для отелей, предлагающих специальные предложения или скидки. Установите '1' или 'true' для включения.
eco_certified	Нет	string		Фильтр для отелей с экологическим сертификатом. Установите '1' или 'true' для включения.
vacation_rentals	Нет	boolean	false	Установите true для поиска аренды отпускного жилья вместо стандартных отелей.
bedrooms	Нет	string		Минимальное количество спален (применяется к аренде отпускного жилья).
bathrooms	Нет	string		Минимальное количество ванных комнат (применяется к аренде отпускного жилья).
property_token	Нет	string		Уникальный токен для конкретного объекта отеля для получения подробной информации.

Скопировать запрос

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))
}

Ответ

Загрузка последнего примера ответа...