C# SDK engine

Google News

Новости Google News с обычным поиском, топиками, источниками, разделами и историями.

engine: google_news constant: XylopSearchEngines.GoogleNews GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleNews,
    new Dictionary<string, string?>
    {
        ["q"] = "tesla",
        ["gl"] = "us",
        ["hl"] = "en",
        ["ceid"] = "US:en",
        ["topic_token"] = "topic_token",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_news`	Движок Google News.
`q`	string	Нет	tesla	Поисковая фраза. Можно не указывать при запросе по topic/publication/story token.
`gl`	string	Нет	`us`	Код страны.
`hl`	string	Нет	`en`	Язык интерфейса.
`ceid`	string	Нет	`US:en`	Регион и язык Google News.
`topic_token`	string	Нет	topic_token	Токен тематического раздела Google News.
`publication_token`	string	Нет	publication_token	Токен конкретного издания.
`story_token`	string	Нет	story_token	Токен группы материалов по одной истории.
`so`	number	Нет	0	Сортировка Google News, например 0 или 1.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_news_url": "https://news.google.com/search?q=tesla&hl=en-US&gl=US&ceid=US:en"
  },
  "search_parameters": {
    "engine": "google_news",
    "q": "tesla",
    "gl": "us",
    "hl": "en",
    "ceid": "US:en"
  },
  "news_results": [
    {
      "position": 1,
      "title": "Tesla shares rise after delivery update",
      "snippet": "Tesla shares moved higher after the company published its latest delivery figures.",
      "source": {
        "name": "Example News",
        "icon": "https://example.com/icon.png"
      },
      "link": "https://example.com/tesla",
      "date": "1 hour ago",
      "iso_date": "2026-05-06T08:00:00Z",
      "story_token": "..."
    }
  ],
  "menu_links": [
    {
      "title": "Business",
      "topic_token": "..."
    }
  ]
}