C# SDK engine

Google Search

Поисковая выдача Google с поддержкой пагинации и гео/языковых параметров.

engine: google constant: XylopSearchEngines.Google GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.Google,
    new Dictionary<string, string?>
    {
        ["q"] = "best laptop",
        ["location"] = "Austin, Texas, United States",
        ["uule"] = "w+CAIQICINVW5pdGVkIFN0YXRlcw",
        ["lat"] = "30.2672",
        ["lon"] = "-97.7431",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google`	Источник поиска.
`q`	string	Да	best laptop	Поисковая фраза.
`location`	string	Нет	Austin, Texas, United States	Город или регион поиска. Нельзя использовать вместе с uule, lat и lon.
`uule`	string	Нет	w+CAIQICINVW5pdGVkIFN0YXRlcw	Google encoded location.
`lat`	number	Нет	30.2672	Широта точки поиска. Используется вместе с lon.
`lon`	number	Нет	-97.7431	Долгота точки поиска. Используется вместе с lat.
`radius`	number	Нет	100	Радиус смещения выдачи в метрах.
`gl`	string	Нет	`us`	Код страны (гео).
`hl`	string	Нет	`en`	Язык интерфейса.
`google_domain`	string	Нет	`google.com`	Региональный домен Google.
`cr`	string	Нет	countryUS	Ограничение результатов по стране.
`lr`	string	Нет	lang_en	Ограничение языка результатов.
`tbm`	string	Нет	isch	Тип поиска: пусто, isch, lcl, vid, nws, shop, pts и другие.
`tbs`	string	Нет	qdr:w	Расширенные фильтры Google.
`safe`	string	Нет	active	Фильтр explicit-контента.
`nfpr`	string	Нет	1	Отключить автоисправление запроса.
`filter`	string	Нет	0	Управление похожими результатами Google.
`num`	number	Нет	10	Количество результатов.
`start`	number	Нет	`0`	Смещение пагинации.
`device`	string	Нет	`desktop`	desktop, tablet или mobile.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "id": "demo-google"
  },
  "search_parameters": {
    "engine": "google",
    "q": "best laptop"
  },
  "organic_results": [
    {
      "position": 1,
      "title": "Best laptops of 2026",
      "link": "https://example.com/laptops"
    }
  ]
}