C# SDK engine

Google AI Mode

AI Mode ответ Google с text_blocks, reconstructed_markdown, references, быстрыми результатами, изображениями, видео, shopping/local блоками и related questions.

engine: google_ai_mode constant: XylopSearchEngines.GoogleAiMode GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleAiMode,
    new Dictionary<string, string?>
    {
        ["q"] = "best cities for remote work",
        ["location"] = "Austin, Texas, United States",
        ["gl"] = "us",
        ["hl"] = "en",
        ["device"] = "desktop",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_ai_mode`	Движок Google AI Mode.
`q`	string	Да	best cities for remote work	Поисковая фраза для AI Mode.
`location`	string	Нет	Austin, Texas, United States	Город или регион поиска.
`gl`	string	Нет	`us`	Код страны.
`hl`	string	Нет	`en`	Язык интерфейса.
`device`	string	Нет	`desktop`	desktop, tablet или mobile.
`image_url`	string	Нет	https://example.com/image.jpg	URL изображения как дополнительный контекст.
`continuable`	string	Нет	`false`	Вернуть токен для продолжения диалога.

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

Поля ответа

Поле	Тип	Источник	Описание
`search_metadata`	object	пример ответа	Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
`text_blocks`	array	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`reconstructed_markdown`	string	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`references`	array	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
`related_questions`	array	пример ответа	Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_ai_mode_url": "https://www.google.com/search?..."
  },
  "text_blocks": [
    {
      "type": "paragraph",
      "snippet": "Austin, Lisbon and Mexico City are often strong options for remote work.",
      "reference_indexes": [
        0
      ]
    }
  ],
  "reconstructed_markdown": "Austin, Lisbon and Mexico City are often strong options for remote work.",
  "references": [
    {
      "title": "Remote work city guide",
      "link": "https://example.com/remote-work",
      "source": "example.com",
      "index": 0
    }
  ],
  "related_questions": [
    {
      "question": "Which city is cheapest for remote workers?"
    }
  ]
}