C# SDK engine

Google Maps Reviews

Отзывы Google Maps по data_id или place_id с информацией о месте, темами, фильтрами, сортировкой и пагинацией.

engine: google_maps_reviews constant: XylopSearchEngines.GoogleMapsReviews GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleMapsReviews,
    new Dictionary<string, string?>
    {
        ["data_id"] = "0x89c259af336b3341:0xa4969e07ce3108de",
        ["place_id"] = "ChIJ...",
        ["hl"] = "en",
        ["sort_by"] = "newestFirst",
        ["topic_id"] = "topic id",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_maps_reviews`	Движок Google Maps Reviews.
`data_id`	string	Нет	0x89c259af336b3341:0xa4969e07ce3108de	Google Maps data_id из Google Maps API. Нужен data_id или place_id.
`place_id`	string	Нет	ChIJ...	Google Maps place_id. Нужен place_id или data_id.
`hl`	string	Нет	`en`	Язык отзывов и интерфейса.
`sort_by`	string	Нет	`qualityScore`	qualityScore, newestFirst, ratingHigh или ratingLow.
`topic_id`	string	Нет	topic id	Фильтр по теме из блока topics. Нельзя использовать вместе с query.
`query`	string	Нет	matcha	Текстовый фильтр по отзывам. Нельзя использовать вместе с topic_id.
`num`	number	Нет	`10`	Количество отзывов от 1 до 20.
`next_page_token`	string	Нет	pagination.next_page_token	Токен следующей страницы отзывов.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_maps_reviews_url": "https://www.google.com/maps/preview/review/listentitiesreviews?..."
  },
  "search_parameters": {
    "engine": "google_maps_reviews",
    "data_id": "0x89c259af336b3341:0xa4969e07ce3108de",
    "hl": "en",
    "sort_by": "newestFirst"
  },
  "place_info": {
    "title": "Example Coffee",
    "address": "123 Main St, New York, NY",
    "rating": 4.5,
    "reviews": 1820,
    "type": "Coffee shop"
  },
  "topics": [
    {
      "keyword": "service",
      "mentions": 38,
      "id": "service"
    }
  ],
  "reviews": [
    {
      "position": 1,
      "link": "https://www.google.com/maps/reviews/data=...",
      "user": {
        "name": "Alex Example",
        "link": "https://www.google.com/maps/contrib/123",
        "contributor_id": "123",
        "local_guide": true,
        "reviews": 42,
        "photos": 8
      },
      "source": "Google",
      "review_id": "ChZ...",
      "likes": 3,
      "rating": 5,
      "date": "2 weeks ago",
      "iso_date": "2026-04-22T12:00:00Z",
      "snippet": "Great coffee and fast service.",
      "extracted_snippet": {
        "original": "Great coffee and fast service."
      },
      "details": {
        "service": 5,
        "atmosphere": 5
      },
      "images": [
        "https://example.com/review.jpg"
      ]
    }
  ],
  "pagination": {
    "next_page_token": "..."
  }
}