C# SDK engine

Google Hotels Autocomplete

Подсказки отелей и направлений по keyword с property_token для дальнейшего запроса деталей или отзывов.

engine: google_hotels_autocomplete constant: XylopSearchEngines.GoogleHotelsAutocomplete GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleHotelsAutocomplete,
    new Dictionary<string, string?>
    {
        ["q"] = "day inn",
        ["gl"] = "us",
        ["hl"] = "en",
        ["currency"] = "USD",
    });

Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_hotels_autocomplete`	Движок Google Hotels Autocomplete.
`q`	string	Да	day inn	Фраза для подсказок отелей.
`gl`	string	Нет	`us`	Код страны.
`hl`	string	Нет	`en`	Язык интерфейса.
`currency`	string	Нет	`USD`	Валюта для связанных Hotels-запросов.

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

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`search_parameters`	object	пример ответа	Нормализованные параметры, с которыми upstream-поиск выполнил запрос.
`suggestions`	array	пример ответа	Подсказки автодополнения или уточнения запроса.

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_hotels_autocomplete_url": "https://www.google.com/travel/search?..."
  },
  "search_parameters": {
    "engine": "google_hotels_autocomplete",
    "q": "day inn"
  },
  "suggestions": [
    {
      "position": 1,
      "value": "Days Inn",
      "type": "accommodation",
      "autocomplete_suggestion": "day inn",
      "kgmid": "/m/04558f"
    },
    {
      "position": 4,
      "value": "Days Inn by Wyndham Washington DC/Connecticut Avenue",
      "type": "accommodation",
      "location": "4400 Connecticut Ave NW, Washington",
      "autocomplete_suggestion": "day inn washington dc",
      "kgmid": "/g/1hf8_s33q",
      "data_cid": "242587712928378716",
      "property_token": "..."
    }
  ]
}