C# SDK engine

Google Images

Google Images выдача в typed DTO-контракте: изображения, shopping blocks, suggested/related searches и явно описанные SerpApi-ссылки для продолжения навигации.

engine: google_images constant: XylopSearchEngines.GoogleImages GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleImages,
    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
API key: Передается SDK автоматически из настроек клиента.

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_images`	Движок Google Images.
`q`	string	Да	coffee	Поисковая фраза для Google Images.
`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.
`chips`	string	Нет	q:coffee,g_1:cup:...	Фильтр из suggested_searches.
`uds`	string	Нет	AMwkrP...	Google uds parameter из suggested_searches.
`tbs`	string	Нет	sur:cl	Расширенные фильтры Google Images.
`imgar`	string	Нет	s	Соотношение сторон, например s для square.
`image_size`	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.
`ijn`	number	Нет	`0`	Номер страницы Google Images, 0..99.
`device`	string	Нет	`desktop`	desktop, tablet или mobile.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "id": "642d73b7de9834017010c43c",
    "status": "Success",
    "google_images_url": "https://www.google.com/search?q=Coffee&hl=en&gl=us&udm=2"
  },
  "search_parameters": {
    "engine": "google_images",
    "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://serpapi.com/searches/.../images/example.jpeg",
      "related_content_id": "Y0hoQW1Kcnc4RXRiV01cIixcIlU2b0pNbkYtZWVWVEFN",
      "serpapi_related_content_link": "https://serpapi.com/search.json?engine=google_images_related_content&related_content_id=...",
      "source": "Wikipedia",
      "title": "Coffee - Wikipedia",
      "link": "https://en.wikipedia.org/wiki/Coffee",
      "original": "https://upload.wikimedia.org/wikipedia/commons/e/e4/Latte_and_dark_coffee.jpg",
      "original_width": 3200,
      "original_height": 2000,
      "is_product": false
    }
  ],
  "suggested_searches": [
    {
      "name": "Cup",
      "link": "https://www.google.com/search?q=coffee+cup&udm=2",
      "chips": "q:coffee,g_1:cup:...",
      "uds": "AMwkrP...",
      "q": "coffee cup",
      "serpapi_link": "https://serpapi.com/search.json?engine=google_images&q=coffee+cup",
      "thumbnail": "https://serpapi.com/searches/.../images/chip.jpeg"
    }
  ],
  "related_searches": [
    {
      "query": "cup coffee",
      "link": "https://www.google.com/search?q=cup+coffee&udm=2",
      "serpapi_link": "https://serpapi.com/search.json?engine=google_images&q=cup+coffee",
      "highlighted_words": [
        "cup"
      ],
      "thumbnail": "https://serpapi.com/searches/.../images/related.jpeg"
    }
  ],
  "serpapi_pagination": {
    "current": 0,
    "next": "https://serpapi.com/search.json?engine=google_images&ijn=1&q=Coffee"
  }
}