C# SDK engine

Google Play Movies

Фильмы Google Play: поиск по фразе, категориям, plain search, чарты, секции, видео-трейлеры и пагинация.

engine: google_play_movies constant: XylopSearchEngines.GooglePlayMovies GET /search

C# пример

Вызов через XylopSearchClient

using Xylop.Api.Client;

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

using var response = await client.SearchJsonAsync(
    XylopSearchEngines.GooglePlayMovies,
    new Dictionary<string, string?>
    {
        ["q"] = "matrix",
        ["movies_category"] = "MOVIE_ACTION_ADVENTURE",
        ["gl"] = "us",
        ["hl"] = "en",
        ["age"] = "AGE_RANGE3",
    });

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

Endpoint

HTTP контракт

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

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

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

Параметр	Тип	Обязателен	Значение	Описание
`api_key` SDK	string	Да	—	Ключ Xylop API. В C# SDK задается один раз в XylopSearchClientOptions.ApiKey или в конструкторе клиента.
`engine` SDK	string	Да	`google_play_movies`	Движок Google Play Movies.
`q`	string	Нет	matrix	Поисковая фраза. Можно не указывать для plain search или category search.
`movies_category`	string	Нет	MOVIE_ACTION_ADVENTURE	Категория Google Play Movies.
`gl`	string	Нет	`us`	Код страны Google Play.
`hl`	string	Нет	`en`	Язык интерфейса.
`age`	string	Нет	AGE_RANGE3	Возрастной фильтр.
`chart`	string	Нет	topselling_paid	Значение из chart_options для top charts.
`next_page_token`	string	Нет	pagination.next_page_token	Токен следующей страницы.
`section_page_token`	string	Нет	section token	Токен пагинации внутри отдельной секции.
`see_more_token`	string	Нет	see_more_token	Токен раскрытия отдельной секции.

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

Поля ответа

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

JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_play_movies_url": "https://play.google.com/store/search?q=matrix&c=movies&hl=en&gl=us"
  },
  "search_parameters": {
    "engine": "google_play_movies",
    "q": "matrix",
    "hl": "en",
    "gl": "us"
  },
  "chart_options": [
    {
      "text": "Top selling",
      "value": "topselling_paid"
    }
  ],
  "organic_results": [
    {
      "title": "Movies",
      "see_more_token": "...",
      "items": [
        {
          "title": "The Matrix",
          "link": "https://play.google.com/store/movies/details?id=...",
          "product_id": "...",
          "rating": 4.7,
          "maturity_rating": "R",
          "video": "https://play.google.com/video/lava/web/player/...",
          "category": "Action & adventure",
          "price": "$3.99",
          "extracted_price": 3.99,
          "thumbnail": "https://play-lh.googleusercontent.com/...",
          "description": "A computer hacker learns about the true nature of his reality."
        }
      ]
    }
  ],
  "pagination": {
    "next_page_token": "..."
  }
}