SDK engine

Google Play Movies

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

engine: google_play_movies TS: XylopSearchEngines.GooglePlayMovies JS: XylopSearchEngines.GooglePlayMovies C#: XylopSearchEngines.GooglePlayMovies Python: XylopSearchEngines.GOOGLE_PLAY_MOVIES PHP: XylopSearchEngines::GOOGLE_PLAY_MOVIES Ruby: XylopApiClient::Engines::GOOGLE_PLAY_MOVIES Java: XylopSearchEngines.GOOGLE_PLAY_MOVIES Kotlin: XylopSearchEngines.GOOGLE_PLAY_MOVIES Swift: XylopSearchEngines.googlePlayMovies Dart: XylopSearchEngines.googlePlayMovies C++: xylop::api::engines::google_play_movies Go: xylop.EngineGooglePlayMovies GET /search
TypeScript пример

Вызов через @xylop/api-client-typescript

import { XylopSearchClient, XylopSearchEngines } from "@xylop/api-client-typescript";

interface SearchResponse {
  [key: string]: unknown;
}

const client = new XylopSearchClient({
  apiKey: "YOUR_API_KEY"
});

const response = await client.search<SearchResponse>(
  XylopSearchEngines.GooglePlayMovies,
  {
    q: "matrix",
    movies_category: "MOVIE_ACTION_ADVENTURE",
    gl: "us",
    hl: "en",
    age: "AGE_RANGE3",
  });

TypeScript SDK написан на TypeScript, генерирует `.d.ts`, поддерживает generic response type и работает через `fetch`.

JavaScript пример

Вызов через @xylop/api-client

import { XylopSearchClient, XylopSearchEngines } from "@xylop/api-client";

const client = new XylopSearchClient({
  apiKey: "YOUR_API_KEY"
});

const response = await client.search(
  XylopSearchEngines.GooglePlayMovies,
  {
    q: "matrix",
    movies_category: "MOVIE_ACTION_ADVENTURE",
    gl: "us",
    hl: "en",
    age: "AGE_RANGE3",
  });

JavaScript SDK работает в Node.js 18+ и современных браузерах через `fetch`; TypeScript declarations входят в npm package.

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.

Python пример

Вызов через xylop-api-client

from xylop_api_client import XylopSearchClient, XylopSearchEngines

client = XylopSearchClient("YOUR_API_KEY")

response = client.search(
    XylopSearchEngines.GOOGLE_PLAY_MOVIES,
    {
        "q": "matrix",
        "movies_category": "MOVIE_ACTION_ADVENTURE",
        "gl": "us",
        "hl": "en",
        "age": "AGE_RANGE3",
    },
)

Python SDK возвращает JSON как обычные `dict`/`list` и не требует runtime-зависимостей.

PHP пример

Вызов через xylop/api-client

<?php

use Xylop\Api\Client\XylopSearchClient;
use Xylop\Api\Client\XylopSearchEngines;

$client = new XylopSearchClient('YOUR_API_KEY');

$response = $client->search(
    XylopSearchEngines::GOOGLE_PLAY_MOVIES,
    [
        'q' => 'matrix',
        'movies_category' => 'MOVIE_ACTION_ADVENTURE',
        'gl' => 'us',
        'hl' => 'en',
        'age' => 'AGE_RANGE3',
    ]
);

PHP SDK использует стандартные stream wrappers, возвращает decoded JSON array и не требует runtime-зависимостей.

Ruby пример

Вызов через xylop-api-client

require "xylop_api_client"

client = XylopApiClient::Client.new(api_key: "YOUR_API_KEY")

response = client.search(
  XylopApiClient::Engines::GOOGLE_PLAY_MOVIES,
  {
    "q" => "matrix",
    "movies_category" => "MOVIE_ACTION_ADVENTURE",
    "gl" => "us",
    "hl" => "en",
    "age" => "AGE_RANGE3",
  }
)

Ruby SDK использует стандартные `net/http`, `json` и возвращает JSON как обычные Hash/Array значения.

Java пример

Вызов через xylop-api-client

import java.util.Map;
import ru.xylop.api.client.XylopSearchClient;
import ru.xylop.api.client.XylopSearchEngines;

var client = new XylopSearchClient("YOUR_API_KEY");

String responseJson = client.searchJson(
    XylopSearchEngines.GOOGLE_PLAY_MOVIES,
    Map.of(
        "q", "matrix",
        "movies_category", "MOVIE_ACTION_ADVENTURE",
        "gl", "us",
        "hl", "en",
        "age", "AGE_RANGE3"
    ));

Java SDK использует `java.net.http.HttpClient`, возвращает JSON-строку и не требует runtime-зависимостей.

Kotlin пример

Вызов через xylop-api-kotlin-client

import ru.xylop.api.kotlin.XylopSearchClient
import ru.xylop.api.kotlin.XylopSearchEngines

val client = XylopSearchClient("YOUR_API_KEY")

val responseJson = client.searchJson(
    XylopSearchEngines.GOOGLE_PLAY_MOVIES,
    mapOf(
        "q" to "matrix",
        "movies_category" to "MOVIE_ACTION_ADVENTURE",
        "gl" to "us",
        "hl" to "en",
        "age" to "AGE_RANGE3",
    ),
)

Kotlin SDK использует JVM `HttpClient`, возвращает JSON-строку и оставляет JSON-маппинг приложению.

Swift пример

Вызов через XylopApiClient

import XylopApiClient

let client = XylopSearchClient(apiKey: "YOUR_API_KEY")

let response = try await client.searchJSON(
    engine: XylopSearchEngines.googlePlayMovies,
    parameters: [
        "q": "matrix",
        "movies_category": "MOVIE_ACTION_ADVENTURE",
        "gl": "us",
        "hl": "en",
        "age": "AGE_RANGE3",
    ]
)

Swift SDK использует Foundation `URLSession`, поддерживает async/await и возвращает Data, JSONSerialization values или caller-owned Decodable models.

Dart пример

Вызов через xylop_api_client

import 'package:xylop_api_client/xylop_api_client.dart';

Future<void> main() async {
  final client = XylopSearchClient('YOUR_API_KEY');

  final response = await client.search(
    XylopSearchEngines.googlePlayMovies,
    <String, Object?>{
      'q': 'matrix',
      'movies_category': 'MOVIE_ACTION_ADVENTURE',
      'gl': 'us',
      'hl': 'en',
      'age': 'AGE_RANGE3',
    },
  );

  print(response);
}

Dart SDK использует `dart:io`, возвращает decoded JSON или raw response text и не требует runtime-зависимостей.

C++ пример

Вызов через Xylop.Api.Cpp

#include <xylop/api/client.hpp>
#include <xylop/api/curl_transport.hpp>

int main()
{
    xylop::api::search_client client(
        "YOUR_API_KEY",
        xylop::api::curl_transport);

    auto response_json = client.search_text(
        xylop::api::engines::google_play_movies,
        {
            {"q", "matrix"},
            {"movies_category", "MOVIE_ACTION_ADVENTURE"},
            {"gl", "us"},
            {"hl", "en"},
            {"age", "AGE_RANGE3"},
        });

    return 0;
}

C++ SDK имеет header-only C++17 core, принимает transport callback и может использовать optional libcurl adapter `xylop::api::curl_transport`.

Go пример

Вызов через Xylop.Api.Go

package main

import (
    "context"
    "log"

    xylop "github.com/Leonid-Vizel/Xylop.AdminPanel/src/Xylop.Api.Go"
)

func main() {
    client, err := xylop.NewClient("YOUR_API_KEY")
    if err != nil {
        log.Fatal(err)
    }

    var response map[string]any
    err = client.SearchJSON(
        context.Background(),
        xylop.EngineGooglePlayMovies,
        xylop.Params(map[string]string{
            "q": "matrix",
            "movies_category": "MOVIE_ACTION_ADVENTURE",
            "gl": "us",
            "hl": "en",
            "age": "AGE_RANGE3",
        }),
        &response)
    if err != nil {
        log.Fatal(err)
    }
}

Go SDK возвращает raw JSON bytes или декодирует ответ в пользовательскую структуру, `map[string]any` либо другой target.

Endpoint

HTTP контракт

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

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

Параметр Тип Обязателен Значение Описание
api_key SDK string Да Ключ Xylop API. В SDK задается один раз в настройках или конструкторе клиента.
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": "..."
  }
}