C# SDK engine

Google Trends

Google Trends interest over time, regions, related queries and topics.

engine: google_trends constant: XylopSearchEngines.GoogleTrends GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleTrends,
    new Dictionary<string, string?>
    {
        ["q"] = "coffee",
        ["data_type"] = "TIMESERIES",
        ["date"] = "today 12-m",
        ["geo"] = "US",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_trends`	Google Trends engine.
`q`	string	Да	coffee	Trend query or comma-separated comparison queries.
`data_type`	string	Нет	TIMESERIES	TIMESERIES, GEO_MAP, RELATED_QUERIES, or RELATED_TOPICS.
`date`	string	Нет	today 12-m	Trend date window.
`geo`	string	Нет	US	Country or region.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_trends_url": "https://trends.google.com/trends/explore?q=coffee"
  },
  "search_parameters": {
    "engine": "google_trends",
    "q": "coffee"
  },
  "interest_over_time": {
    "timeline_data": [
      {
        "date": "May 2026",
        "values": [
          {
            "query": "coffee",
            "value": "82",
            "extracted_value": 82
          }
        ]
      }
    ]
  }
}