C# SDK engine

Google Immersive Product

Карточка товара Google Shopping по page_token: превью, цена, магазины/stores, отзывы, инсайты, видео, форумы, варианты товара и токен следующей страницы магазинов.

engine: google_immersive_product constant: XylopSearchEngines.GoogleImmersiveProduct GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GoogleImmersiveProduct,
    new Dictionary<string, string?>
    {
        ["page_token"] = "immersive product page_token",
        ["more_stores"] = "true",
        ["next_page_token"] = "product_results.stores_next_page_token",
        ["no_cache"] = "false",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_immersive_product`	Движок Google Immersive Product.
`page_token`	string	Да	immersive product page_token	Токен immersive product из Google Shopping / AI Mode shopping result.
`more_stores`	string	Нет	`false`	Вернуть расширенный список магазинов в одном запросе.
`next_page_token`	string	Нет	product_results.stores_next_page_token	Токен следующей страницы магазинов из product_results.stores_next_page_token.
`no_cache`	string	Нет	`false`	Принудительно запросить свежий ответ.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_immersive_product_url": "https://www.google.com/async/oapv?..."
  },
  "search_parameters": {
    "engine": "google_immersive_product",
    "page_token": "eyJ..."
  },
  "product_results": {
    "title": "LG Class G4 Series OLED evo 4K Smart TV",
    "brand": "LG",
    "rating": 4.8,
    "reviews": 3551,
    "price_range": "$1,797-$2,200",
    "stores": [
      {
        "name": "Best Buy",
        "link": "https://www.bestbuy.com/site/...",
        "title": "LG - 55\" Class G4 Series OLED evo 4K UHD Smart webOS TV (2024)",
        "rating": 4.6,
        "reviews": 623,
        "payment_methods": "PayPal, Zip accepted",
        "details_and_offers": [
          "In stock online",
          "$50 delivery"
        ],
        "price": "$2,199.99",
        "extracted_price": 2199.99,
        "shipping": "+ $50.00",
        "total": "$2,420.49",
        "extracted_total": 2420.49
      }
    ],
    "stores_next_page_token": "f69uOnica15...",
    "about_the_product": {
      "title": "65 inch LG OLED evo AI G4 4K Smart TV 2024",
      "description": "Bring the movie theatre experience into your home..."
    },
    "ratings": [
      {
        "stars": 5,
        "amount": 3166
      }
    ]
  },
  "related_searches": [
    {
      "query": "lg smart tvs",
      "link": "https://www.google.com/search?cs=1&q=lg+smart+tvs"
    }
  ]
}