C# SDK engine

Google Related Questions

Раскрытие дополнительных вопросов из блока People also ask по next_page_token из обычного Google Search ответа.

engine: google_related_questions constant: XylopSearchEngines.GoogleRelatedQuestions GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

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

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

Endpoint

HTTP контракт

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

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

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

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

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_related_questions_url": "https://www.google.com/search?..."
  },
  "search_parameters": {
    "engine": "google_related_questions",
    "next_page_token": "..."
  },
  "related_questions": [
    {
      "question": "What are negative effects of coffee?",
      "type": "featured_snippet",
      "snippet": "Caffeine can cause insomnia, nervousness, restlessness, nausea and increased heart rate.",
      "title": "Caffeine - Uses, Side Effects, and More",
      "link": "https://example.com/caffeine",
      "displayed_link": "https://example.com",
      "next_page_token": "..."
    },
    {
      "question": "Can I drink coffee every day?",
      "type": "ai_overview",
      "text_blocks": [
        {
          "type": "paragraph",
          "snippet": "For many adults, moderate coffee intake can fit into a balanced diet.",
          "reference_indexes": [
            0
          ]
        }
      ],
      "references": [
        {
          "title": "Coffee and health",
          "link": "https://example.com/coffee-health",
          "source": "Example Health",
          "index": 0
        }
      ],
      "page_token": "...",
      "next_page_token": "..."
    }
  ]
}