C# SDK engine

Google Hotels Reviews

Отзывы конкретного отеля по property_token с фильтрами категории, источника, сортировки и пагинацией.

engine: google_hotels_reviews constant: XylopSearchEngines.GoogleHotelsReviews GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleHotelsReviews,
    new Dictionary<string, string?>
    {
        ["property_token"] = "hotel property_token",
        ["hl"] = "en",
        ["category_token"] = "reviews_breakdown category_token",
        ["sort_by"] = "1",
        ["source_number"] = "0",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_hotels_reviews`	Движок Google Hotels Reviews.
`property_token`	string	Да	hotel property_token	Токен конкретного отеля из Google Hotels Properties API.
`hl`	string	Нет	`en`	Язык отзывов и интерфейса.
`category_token`	string	Нет	reviews_breakdown category_token	Фильтр по категории отзывов.
`sort_by`	number	Нет	`1`	1 helpful, 2 recent, 3 highest, 4 lowest.
`source_number`	number	Нет	`0`	0 все отзывы, -1 Google, либо номер источника отеля.
`next_page_token`	string	Нет	pagination.next_page_token	Токен следующей страницы отзывов.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_hotels_reviews_url": "https://www.google.com/_/TravelFrontendUi/data/batchexecute?..."
  },
  "search_parameters": {
    "engine": "google_hotels_reviews",
    "property_token": "..."
  },
  "reviews": [
    {
      "user": {
        "name": "Sydney Granat",
        "link": "https://www.google.com/maps/contrib/113253605843578019764",
        "thumbnail": "https://example.com/avatar.jpg"
      },
      "source": "Google",
      "rating": 5,
      "best_rating": 5,
      "date": "2 months ago",
      "snippet": "I had an incredible experience at this hotel.",
      "subratings": {
        "rooms": 5,
        "service": 5,
        "location": 5
      },
      "hotel_highlights": [
        "Luxury",
        "Great value"
      ]
    }
  ],
  "pagination": {
    "next_page_token": "..."
  }
}