C# SDK engine

Google Play Store

Google Play Apps Store search, charts and highlighted apps.

engine: google_play constant: XylopSearchEngines.GooglePlay GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GooglePlay,
    new Dictionary<string, string?>
    {
        ["store"] = "apps",
        ["q"] = "calendar",
        ["apps_category"] = "APPLICATION",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_play`	Google Play Store engine.
`store`	string	Нет	`apps`	Store section.
`q`	string	Нет	calendar	Search query.
`apps_category`	string	Нет	APPLICATION	Apps category.

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

Поля ответа

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

JSON

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

{
  "search_metadata": { "status": "Success" },
  "organic_results": [
    {
      "title": "Apps",
      "items": [
        {
          "title": "Example App",
          "product_id": "com.example.app"
        }
      ]
    }
  ]
}