C# SDK engine

Google Lens

Google Lens visual search by image URL with visual matches, products, exact matches and related content.

engine: google_lens constant: XylopSearchEngines.GoogleLens GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleLens,
    new Dictionary<string, string?>
    {
        ["url"] = "https://example.com/image.jpg",
        ["type"] = "all",
        ["q"] = "coffee grinder",
        ["hl"] = "en",
        ["country"] = "us",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_lens`	Google Lens engine.
`url`	string	Да	https://example.com/image.jpg	Public image URL to analyze.
`type`	string	Нет	`all`	all, products, exact_matches, visual_matches or text.
`q`	string	Нет	coffee grinder	Optional text refinement.
`hl`	string	Нет	`en`	Interface language.
`country`	string	Нет	`us`	Country code.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_lens_url": "https://lens.google.com/uploadbyurl?url=https://example.com/image.jpg"
  },
  "search_parameters": {
    "engine": "google_lens",
    "url": "https://example.com/image.jpg",
    "type": "all"
  },
  "visual_matches": [
    {
      "position": 1,
      "title": "Manual coffee grinder",
      "link": "https://example.com/grinder",
      "source": "Example Store",
      "thumbnail": "https://example.com/grinder-thumb.jpg"
    }
  ],
  "related_content": [
    {
      "query": "manual coffee grinder",
      "link": "https://www.google.com/search?q=manual+coffee+grinder"
    }
  ]
}