C# SDK engine

Google Images Related Content

Похожие изображения и связанные поиски по related_content_id из результата Google Images.

engine: google_images_related_content constant: XylopSearchEngines.GoogleImagesRelatedContent GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleImagesRelatedContent,
    new Dictionary<string, string?>
    {
        ["related_content_id"] = "images_results.related_content_id",
        ["q"] = "coffee",
        ["hl"] = "en",
        ["gl"] = "us",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_images_related_content`	Движок Google Images Related Content.
`related_content_id`	string	Да	images_results.related_content_id	ID из google_images.images_results.
`q`	string	Нет	coffee	Лучше передавать исходный запрос Google Images.
`hl`	string	Нет	`en`	Язык интерфейса.
`gl`	string	Нет	`us`	Код страны.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "id": "644bab2dde98340723972102",
    "status": "Success",
    "google_images_related_content_url": "https://www.google.com/_/VisualFrontendUi/data/batchexecute?hl=en&gl=us"
  },
  "search_parameters": {
    "engine": "google_images_related_content",
    "hl": "en",
    "gl": "us",
    "q": "coffee",
    "related_content_id": "Y0hoQW1Kcnc4RXRiV01cIixcIlU2b0pNbkYtZWVWVEFN"
  },
  "related_content": [
    {
      "position": 1,
      "title": "Coffee image source",
      "source": "Example",
      "source_icon": "https://serpapi.com/searches/.../images/icon.png",
      "link": "https://example.com/coffee",
      "original": "https://example.com/coffee.jpg",
      "original_width": 1200,
      "original_height": 800,
      "thumbnail": "https://serpapi.com/searches/.../images/thumb.png",
      "thumbnail_width": 261,
      "thumbnail_height": 193,
      "related_content_id": "Wld5bWhqN053VG85SE1cIixcIjQ4Wjl4akpyZXdiV2JN",
      "serpapi_related_content_link": "https://serpapi.com/search.json?engine=google_images_related_content&related_content_id=..."
    }
  ],
  "related_searches": [
    {
      "position": 1,
      "query": "coffee cup",
      "link": "https://www.google.com/search?q=coffee+cup&udm=2",
      "serpapi_link": "https://serpapi.com/search.json?engine=google_images&q=coffee+cup",
      "thumbnail": "https://serpapi.com/searches/.../images/related.jpeg"
    }
  ],
  "see_more_link": "https://www.google.com/search?q=coffee&udm=2",
  "serpapi_see_more_link": "https://serpapi.com/search.json?engine=google_images&q=coffee"
}