C# SDK engine

Google AI Overview

Отдельный запрос за AI Overview по короткоживущему page_token из основного Google Search ответа.

engine: google_ai_overview constant: XylopSearchEngines.GoogleAiOverview GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleAiOverview,
    new Dictionary<string, string?>
    {
        ["page_token"] = "ai_overview.page_token",
        ["no_cache"] = "false",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_ai_overview`	Движок Google AI Overview.
`page_token`	string	Да	ai_overview.page_token	Токен из ai_overview.page_token основного Google Search ответа.
`no_cache`	string	Нет	`false`	Принудительно запросить свежий ответ.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_ai_overview_url": "https://www.google.com/async/folsrch?..."
  },
  "search_parameters": {
    "engine": "google_ai_overview",
    "page_token": "..."
  },
  "ai_overview": {
    "text_blocks": [
      {
        "type": "paragraph",
        "snippet": "Android Runtime is the managed runtime used by apps and some system services.",
        "reference_indexes": [
          0
        ]
      }
    ],
    "references": [
      {
        "title": "Android runtime",
        "link": "https://example.com/android-runtime",
        "source": "example.com",
        "index": 0
      }
    ]
  }
}