C# SDK engine

Google Events

События из Google Events с датой, адресом, площадкой, билетными ссылками и описанием.

engine: google_events constant: XylopSearchEngines.GoogleEvents GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleEvents,
    new Dictionary<string, string?>
    {
        ["q"] = "concerts in austin",
        ["location"] = "Austin, Texas, United States",
        ["gl"] = "us",
        ["hl"] = "en",
        ["htichips"] = "date:week",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_events`	Движок Google Events.
`q`	string	Да	concerts in austin	Поисковая фраза для событий.
`location`	string	Нет	Austin, Texas, United States	Город или регион поиска.
`gl`	string	Нет	`us`	Код страны.
`hl`	string	Нет	`en`	Язык интерфейса.
`htichips`	string	Нет	date:week	Фильтры даты или типа события.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_events_url": "https://www.google.com/search?..."
  },
  "search_information": {
    "events_results_state": "Results for exact spelling"
  },
  "events_results": [
    {
      "title": "Live Music Night",
      "date": {
        "start_date": "Dec 7",
        "when": "Sun, Dec 7, 8:00 PM"
      },
      "address": [
        "Example Venue",
        "Austin, TX"
      ],
      "link": "https://example.com/event",
      "ticket_info": [
        {
          "source": "Example Tickets",
          "link": "https://example.com/tickets",
          "link_type": "tickets"
        }
      ]
    }
  ]
}