C# SDK engine

Google Forums

Результаты вкладки Google Forums: обсуждения, ответы, sitelinks, related searches и пагинация.

engine: google_forums constant: XylopSearchEngines.GoogleForums GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleForums,
    new Dictionary<string, string?>
    {
        ["q"] = "best programming language",
        ["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_forums
API key: Передается SDK автоматически из настроек клиента.

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_forums`	Движок Google Forums.
`q`	string	Да	best programming language	Поисковая фраза для вкладки Forums.
`location`	string	Нет	Austin, Texas, United States	Город или регион поиска.
`gl`	string	Нет	`us`	Код страны.
`hl`	string	Нет	`en`	Язык интерфейса.
`device`	string	Нет	`desktop`	desktop, tablet или mobile.
`start`	number	Нет	`0`	Смещение для пагинации.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_forums_url": "https://www.google.com/search?q=best+programming+language&udm=18"
  },
  "search_parameters": {
    "engine": "google_forums",
    "q": "best programming language",
    "device": "desktop"
  },
  "search_information": {
    "organic_results_state": "Results for exact spelling"
  },
  "organic_results": [
    {
      "position": 1,
      "title": "For you what is the best programming language?",
      "link": "https://www.reddit.com/r/learnprogramming/...",
      "displayed_meta": "70+ comments · 2 years ago",
      "source": "Reddit · r/learnprogramming",
      "answers": [
        {
          "answer": "Python is often recommended because it is beginner-friendly.",
          "top_answer": true,
          "votes": 43
        }
      ]
    }
  ],
  "related_searches": [
    {
      "query": "best programming language for beginners",
      "link": "https://www.google.com/search?..."
    }
  ],
  "pagination": {
    "current": 1
  }
}