C# SDK engine

DuckDuckGo Search Assist

DuckDuckGo Search Assist suggestions for autocomplete-style query expansion.

engine: duckduckgo_search_assist constant: XylopSearchEngines.DuckDuckGoSearchAssist GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.DuckDuckGoSearchAssist,
    new Dictionary<string, string?>
    {
        ["q"] = "open source",
        ["kl"] = "us-en",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`duckduckgo_search_assist`	DuckDuckGo Search Assist engine.
`q`	string	Да	open source	Suggestion seed query.
`kl`	string	Нет	`us-en`	DuckDuckGo region.

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

Поля ответа

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

JSON

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

{"search_metadata":{"status":"Success"},"search_parameters":{"engine":"duckduckgo_search_assist","q":"open source"},"suggestions":[{"value":"open source software"}]}