C# SDK engine

Google Images Light

Быстрая Google Images выдача в typed DTO-контракте: компактные image results, raw links, SerpApi thumbnails и пагинация через start.

engine: google_images_light constant: XylopSearchEngines.GoogleImagesLight GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleImagesLight,
    new Dictionary<string, string?>
    {
        ["q"] = "coffee",
        ["location"] = "Austin, Texas, United States",
        ["uule"] = "w+CAIQICINVW5pdGVkIFN0YXRlcw",
        ["google_domain"] = "google.com",
        ["gl"] = "us",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_images_light`	Движок Google Images Light.
`q`	string	Да	coffee	Поисковая фраза для Google Images Light.
`location`	string	Нет	Austin, Texas, United States	Город или регион поиска. Нельзя использовать вместе с uule.
`uule`	string	Нет	w+CAIQICINVW5pdGVkIFN0YXRlcw	Google encoded location.
`google_domain`	string	Нет	`google.com`	Региональный домен Google.
`gl`	string	Нет	`us`	Код страны.
`hl`	string	Нет	`en`	Язык интерфейса.
`cr`	string	Нет	countryUS	Ограничение результатов по стране.
`period_unit`	string	Нет	d	s, n, h, d, w, m или y для свежих изображений.
`period_value`	number	Нет	7	Размер периода для period_unit.
`start_date`	string	Нет	20260101	Начало периода YYYYMMDD.
`end_date`	string	Нет	20260131	Конец периода YYYYMMDD.
`tbs`	string	Нет	sur:cl	Расширенные фильтры Google Images Light.
`imgar`	string	Нет	s	Соотношение сторон, например s для square.
`imgsz`	string	Нет	l	Размер изображения: l, m, i, 2mp и другие.
`image_color`	string	Нет	trans	Цветовой фильтр.
`image_type`	string	Нет	photo	face, photo, clipart, lineart или animated.
`licenses`	string	Нет	cl	Фильтр лицензий, например cl или ol.
`safe`	string	Нет	active	Фильтр explicit-контента.
`nfpr`	string	Нет	1	Отключить автоисправление запроса.
`filter`	string	Нет	0	Управление похожими/omitted results.
`start`	number	Нет	`0`	Смещение результатов: 0, 10, 20 и так далее.
`device`	string	Нет	`desktop`	desktop, tablet или mobile.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "id": "680edc71877a91117bfd76df",
    "status": "Success",
    "google_images_light_url": "https://www.google.com/search?q=Coffee&oq=Coffee&hl=en&gl=us&tbm=isch&gbv=1"
  },
  "search_parameters": {
    "engine": "google_images_light",
    "q": "Coffee",
    "google_domain": "google.com",
    "hl": "en",
    "gl": "us",
    "device": "desktop"
  },
  "search_information": {
    "image_results_state": "Results for exact spelling"
  },
  "images_results": [
    {
      "position": 1,
      "thumbnail": "https://encrypted-tbn0.gstatic.com/images?q=tbn:ANd9GcRlZTLx2ZnPg9Dd3HBYDWWVmZG_u2bSt-AwFw&s",
      "serpapi_thumbnail": "https://serpapi.com/images/url/n32iFHicuxmTUVJSUGylr5-al1xUWVCSmqJbkpRnoJdeXJJYkpmsl5yfq5-Zm5ieWmxfaAuUsXL0S7F0Tw7KiQrxqTCKygtIt3RJMfZwinQJDw_LjXKPLzVKCi7RdSx3K1crBgB8aSF4",
      "title": "Coffee - Wikipedia",
      "source": "Wikipedia, the free encyclopedia",
      "link": "https://en.wikipedia.org/wiki/Coffee",
      "raw_link": "https://en.wikipedia.org/wiki/Coffee",
      "original": "https://upload.wikimedia.org/wikipedia/commons/thumb/e/e4/Latte_and_dark_coffee.jpg/1200px-Latte_and_dark_coffee.jpg",
      "original_width": 1200,
      "original_height": 750,
      "related_content_id": "b0JsYkFFclBGYWVsY01cIixcIlU2b0pNbkYtZWVWVEFN",
      "serpapi_related_content_link": "https://serpapi.com/search.json?engine=google_images_related_content&gl=us&hl=en&q=Coffee&related_content_id=...",
      "source_logo": "https://serpapi.com/images/url/vumAE3icu9mXUVJSUGylr5-al1xUWVCSmqJbkpRnqJdeXJJYkpmsl5yfq5-WWJaZnJ8XZmRfWpRji9CgV56ZnVmQmpKZqJdflK6WnJOZmldi6-nr6O4aH-zqGOTsoVacWZVqa2imVlJZkGrr5hjm6ezvp5aWmJOTlJicHZ9fUFJsGxIZ4KoT7BnlqhMa5AMAISMzHA",
      "is_product": false
    }
  ],
  "serpapi_pagination": {
    "current": 1,
    "next": "https://serpapi.com/search.json?device=desktop&engine=google_images_light&gl=us&google_domain=google.com&hl=en&q=Coffee&start=10"
  }
}