C# SDK engine

Google Hotels

Google Hotels properties and property details with prices, amenities, ratings and pagination.

engine: google_hotels constant: XylopSearchEngines.GoogleHotels GET /search

C# пример

Вызов через 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.

Endpoint

HTTP контракт

URL: https://api.xylop.ru/search
Engine: google_hotels
API key: Передается SDK автоматически из настроек клиента.

Входные параметры

Параметры запроса

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`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-провайдера и параметров запроса.

JSON

Пример ответа

{
  "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
      }
    }
  ]
}