Google Hotels
Google Hotels properties and property details with prices, amenities, ratings and pagination.
Вызов через @xylop/api-client-typescript
import { XylopSearchClient, XylopSearchEngines } from "@xylop/api-client-typescript";
interface SearchResponse {
[key: string]: unknown;
}
const client = new XylopSearchClient({
apiKey: "YOUR_API_KEY"
});
const response = await client.search<SearchResponse>(
XylopSearchEngines.GoogleHotels,
{
q: "Austin hotels",
check_in_date: "2026-06-01",
check_out_date: "2026-06-02",
property_token: "property token",
next_page_token: "pagination.next_page_token",
});
TypeScript SDK написан на TypeScript, генерирует `.d.ts`, поддерживает generic response type и работает через `fetch`.
Вызов через @xylop/api-client
import { XylopSearchClient, XylopSearchEngines } from "@xylop/api-client";
const client = new XylopSearchClient({
apiKey: "YOUR_API_KEY"
});
const response = await client.search(
XylopSearchEngines.GoogleHotels,
{
q: "Austin hotels",
check_in_date: "2026-06-01",
check_out_date: "2026-06-02",
property_token: "property token",
next_page_token: "pagination.next_page_token",
});
JavaScript SDK работает в Node.js 18+ и современных браузерах через `fetch`; TypeScript declarations входят в npm package.
Вызов через XylopSearchClient
using Xylop.Api.Client;
var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");
using var response = await client.SearchJsonAsync(
XylopSearchEngines.GoogleHotels,
new Dictionary<string, string?>
{
["q"] = "Austin hotels",
["check_in_date"] = "2026-06-01",
["check_out_date"] = "2026-06-02",
["property_token"] = "property token",
["next_page_token"] = "pagination.next_page_token",
});
Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.
Вызов через xylop-api-client
from xylop_api_client import XylopSearchClient, XylopSearchEngines
client = XylopSearchClient("YOUR_API_KEY")
response = client.search(
XylopSearchEngines.GOOGLE_HOTELS,
{
"q": "Austin hotels",
"check_in_date": "2026-06-01",
"check_out_date": "2026-06-02",
"property_token": "property token",
"next_page_token": "pagination.next_page_token",
},
)
Python SDK возвращает JSON как обычные `dict`/`list` и не требует runtime-зависимостей.
Вызов через xylop/api-client
<?php
use Xylop\Api\Client\XylopSearchClient;
use Xylop\Api\Client\XylopSearchEngines;
$client = new XylopSearchClient('YOUR_API_KEY');
$response = $client->search(
XylopSearchEngines::GOOGLE_HOTELS,
[
'q' => 'Austin hotels',
'check_in_date' => '2026-06-01',
'check_out_date' => '2026-06-02',
'property_token' => 'property token',
'next_page_token' => 'pagination.next_page_token',
]
);
PHP SDK использует стандартные stream wrappers, возвращает decoded JSON array и не требует runtime-зависимостей.
Вызов через xylop-api-client
require "xylop_api_client"
client = XylopApiClient::Client.new(api_key: "YOUR_API_KEY")
response = client.search(
XylopApiClient::Engines::GOOGLE_HOTELS,
{
"q" => "Austin hotels",
"check_in_date" => "2026-06-01",
"check_out_date" => "2026-06-02",
"property_token" => "property token",
"next_page_token" => "pagination.next_page_token",
}
)
Ruby SDK использует стандартные `net/http`, `json` и возвращает JSON как обычные Hash/Array значения.
Вызов через xylop-api-client
import java.util.Map;
import ru.xylop.api.client.XylopSearchClient;
import ru.xylop.api.client.XylopSearchEngines;
var client = new XylopSearchClient("YOUR_API_KEY");
String responseJson = client.searchJson(
XylopSearchEngines.GOOGLE_HOTELS,
Map.of(
"q", "Austin hotels",
"check_in_date", "2026-06-01",
"check_out_date", "2026-06-02",
"property_token", "property token",
"next_page_token", "pagination.next_page_token"
));
Java SDK использует `java.net.http.HttpClient`, возвращает JSON-строку и не требует runtime-зависимостей.
Вызов через xylop-api-kotlin-client
import ru.xylop.api.kotlin.XylopSearchClient
import ru.xylop.api.kotlin.XylopSearchEngines
val client = XylopSearchClient("YOUR_API_KEY")
val responseJson = client.searchJson(
XylopSearchEngines.GOOGLE_HOTELS,
mapOf(
"q" to "Austin hotels",
"check_in_date" to "2026-06-01",
"check_out_date" to "2026-06-02",
"property_token" to "property token",
"next_page_token" to "pagination.next_page_token",
),
)
Kotlin SDK использует JVM `HttpClient`, возвращает JSON-строку и оставляет JSON-маппинг приложению.
Вызов через XylopApiClient
import XylopApiClient
let client = XylopSearchClient(apiKey: "YOUR_API_KEY")
let response = try await client.searchJSON(
engine: XylopSearchEngines.googleHotels,
parameters: [
"q": "Austin hotels",
"check_in_date": "2026-06-01",
"check_out_date": "2026-06-02",
"property_token": "property token",
"next_page_token": "pagination.next_page_token",
]
)
Swift SDK использует Foundation `URLSession`, поддерживает async/await и возвращает Data, JSONSerialization values или caller-owned Decodable models.
Вызов через xylop_api_client
import 'package:xylop_api_client/xylop_api_client.dart';
Future<void> main() async {
final client = XylopSearchClient('YOUR_API_KEY');
final response = await client.search(
XylopSearchEngines.googleHotels,
<String, Object?>{
'q': 'Austin hotels',
'check_in_date': '2026-06-01',
'check_out_date': '2026-06-02',
'property_token': 'property token',
'next_page_token': 'pagination.next_page_token',
},
);
print(response);
}
Dart SDK использует `dart:io`, возвращает decoded JSON или raw response text и не требует runtime-зависимостей.
Вызов через Xylop.Api.Cpp
#include <xylop/api/client.hpp>
#include <xylop/api/curl_transport.hpp>
int main()
{
xylop::api::search_client client(
"YOUR_API_KEY",
xylop::api::curl_transport);
auto response_json = client.search_text(
xylop::api::engines::google_hotels,
{
{"q", "Austin hotels"},
{"check_in_date", "2026-06-01"},
{"check_out_date", "2026-06-02"},
{"property_token", "property token"},
{"next_page_token", "pagination.next_page_token"},
});
return 0;
}
C++ SDK имеет header-only C++17 core, принимает transport callback и может использовать optional libcurl adapter `xylop::api::curl_transport`.
Вызов через Xylop.Api.Go
package main
import (
"context"
"log"
xylop "github.com/Leonid-Vizel/Xylop.AdminPanel/src/Xylop.Api.Go"
)
func main() {
client, err := xylop.NewClient("YOUR_API_KEY")
if err != nil {
log.Fatal(err)
}
var response map[string]any
err = client.SearchJSON(
context.Background(),
xylop.EngineGoogleHotels,
xylop.Params(map[string]string{
"q": "Austin hotels",
"check_in_date": "2026-06-01",
"check_out_date": "2026-06-02",
"property_token": "property token",
"next_page_token": "pagination.next_page_token",
}),
&response)
if err != nil {
log.Fatal(err)
}
}
Go SDK возвращает raw JSON bytes или декодирует ответ в пользовательскую структуру, `map[string]any` либо другой target.
HTTP контракт
- URL
https://api.xylop.ru/search- Engine
google_hotels- API key
- Передается SDK автоматически из настроек клиента.
Параметры запроса
| Параметр | Тип | Обязателен | Значение | Описание |
|---|---|---|---|---|
api_key
SDK
|
string | Да | — | Ключ Xylop API. В SDK задается один раз в настройках или конструкторе клиента. |
engine
SDK
|
string | Да |
google_hotels
|
Google Hotels engine. |
q
|
string | Да | Austin hotels | Hotel destination or query. |
check_in_date
|
string | Да | 2026-06-01 | Check-in date in YYYY-MM-DD format. |
check_out_date
|
string | Да | 2026-06-02 | Check-out date in YYYY-MM-DD format. |
property_token
|
string | Нет | property token | Token for property details. |
next_page_token
|
string | Нет | pagination.next_page_token | Token for next properties page. |
currency
|
string | Нет |
USD
|
Price currency. |
Поля ответа
| Поле | Тип | Источник | Описание |
|---|---|---|---|
search_metadata |
object | пример ответа | Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера. |
search_parameters |
object | пример ответа | Нормализованные параметры, с которыми upstream-поиск выполнил запрос. |
properties |
array | пример ответа | Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса. |
Пример ответа
{
"search_metadata": {
"status": "Success",
"google_hotels_url": "https://www.google.com/travel/hotels"
},
"search_parameters": {
"engine": "google_hotels",
"q": "Austin hotels",
"check_in_date": "2026-06-01",
"check_out_date": "2026-06-02"
},
"properties": [
{
"name": "Example Hotel",
"property_token": "token",
"overall_rating": 4.4,
"reviews": 932,
"rate_per_night": {
"lowest": "$149",
"extracted_lowest": 149
}
}
]
}