C# SDK engine
Google Light Search
Упрощённая и быстрая выдача с блоками answer_box, knowledge_graph и organic_results.
C# пример
Вызов через XylopSearchClient
using Xylop.Api.Client;
var client = new XylopSearchClient(new HttpClient(), "YOUR_API_KEY");
using var response = await client.SearchJsonAsync(
XylopSearchEngines.GoogleLight,
new Dictionary<string, string?>
{
["q"] = "weather in london",
["device"] = "desktop",
["google_domain"] = "google.com",
});
Для типизированного режима используйте `SearchAsync<TResponse>` и response-модель из `Xylop.Logic.SerpApiResponses.*`, которая входит в пакет C# SDK.
Endpoint
HTTP контракт
- URL
https://api.xylop.ru/search- Engine
google_light- API key
- Передается SDK автоматически из настроек клиента.
Входные параметры
Параметры запроса
| Параметр | Тип | Обязателен | Значение | Описание |
|---|---|---|---|---|
api_key
SDK
|
string | Да | — | Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента. |
engine
SDK
|
string | Да |
google_light
|
Лёгкий движок Google. |
q
|
string | Да | weather in london | Поисковая фраза. |
device
|
string | Нет |
desktop
|
Тип устройства. |
google_domain
|
string | Нет |
google.com
|
Региональный домен Google. |
Выходные параметры
Поля ответа
| Поле | Тип | Источник | Описание |
|---|---|---|---|
search_metadata |
object | пример ответа | Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера. |
answer_box |
object | пример ответа | Быстрый ответ или выделенный блок SERP. |
organic_results |
array | пример ответа | Основные органические результаты выдачи: позиции, заголовки, ссылки и сниппеты. |
JSON
Пример ответа
{
"search_metadata": {
"status": "Success",
"google_light_url": "https://www.google.com/search?..."
},
"answer_box": {
"type": "weather_result",
"temperature": "18",
"unit": "C",
"location": "London"
},
"organic_results": [
{
"position": 1,
"title": "Weather forecast",
"link": "https://example.com/weather"
}
]
}