SDK engine

Google Trends Trending Now

Google Trends currently trending searches with volumes and article links.

engine: google_trends_trending_now TS: XylopSearchEngines.GoogleTrendsTrendingNow JS: XylopSearchEngines.GoogleTrendsTrendingNow C#: XylopSearchEngines.GoogleTrendsTrendingNow Python: XylopSearchEngines.GOOGLE_TRENDS_TRENDING_NOW PHP: XylopSearchEngines::GOOGLE_TRENDS_TRENDING_NOW Ruby: XylopApiClient::Engines::GOOGLE_TRENDS_TRENDING_NOW Java: XylopSearchEngines.GOOGLE_TRENDS_TRENDING_NOW Kotlin: XylopSearchEngines.GOOGLE_TRENDS_TRENDING_NOW Swift: XylopSearchEngines.googleTrendsTrendingNow Dart: XylopSearchEngines.googleTrendsTrendingNow C++: xylop::api::engines::google_trends_trending_now Go: xylop.EngineGoogleTrendsTrendingNow 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.GoogleTrendsTrendingNow,
  {
    geo: "US",
    hl: "en",
    hours: "24",
  });

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.GoogleTrendsTrendingNow,
  {
    geo: "US",
    hl: "en",
    hours: "24",
  });

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.GoogleTrendsTrendingNow,
    new Dictionary<string, string?>
    {
        ["geo"] = "US",
        ["hl"] = "en",
        ["hours"] = "24",
    });

Для типизированного режима используйте `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_TRENDS_TRENDING_NOW,
    {
        "geo": "US",
        "hl": "en",
        "hours": "24",
    },
)

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_TRENDS_TRENDING_NOW,
    [
        'geo' => 'US',
        'hl' => 'en',
        'hours' => '24',
    ]
);

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_TRENDS_TRENDING_NOW,
  {
    "geo" => "US",
    "hl" => "en",
    "hours" => "24",
  }
)

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_TRENDS_TRENDING_NOW,
    Map.of(
        "geo", "US",
        "hl", "en",
        "hours", "24"
    ));

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_TRENDS_TRENDING_NOW,
    mapOf(
        "geo" to "US",
        "hl" to "en",
        "hours" to "24",
    ),
)

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.googleTrendsTrendingNow,
    parameters: [
        "geo": "US",
        "hl": "en",
        "hours": "24",
    ]
)

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.googleTrendsTrendingNow,
    <String, Object?>{
      'geo': 'US',
      'hl': 'en',
      'hours': '24',
    },
  );

  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_trends_trending_now,
        {
            {"geo", "US"},
            {"hl", "en"},
            {"hours", "24"},
        });

    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.EngineGoogleTrendsTrendingNow,
        xylop.Params(map[string]string{
            "geo": "US",
            "hl": "en",
            "hours": "24",
        }),
        &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_trends_trending_now
API key
Передается SDK автоматически из настроек клиента.
Входные параметры

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

Параметр Тип Обязателен Значение Описание
api_key SDK string Да Ключ Xylop API. В SDK задается один раз в настройках или конструкторе клиента.
engine SDK string Да google_trends_trending_now Google Trends Trending Now engine.
geo string Нет US Country or region.
hl string Нет en Interface language.
hours number Нет 24 Time window.
Выходные параметры

Поля ответа

Поле Тип Источник Описание
search_metadata object пример ответа Метаданные запроса: статус, идентификатор, время выполнения и служебная информация провайдера.
trending_searches array пример ответа Типизированное поле ответа для этого engine; структура зависит от upstream-провайдера и параметров запроса.
JSON

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

{
  "search_metadata": {
    "status": "Success",
    "google_trends_trending_now_url": "https://trends.google.com/trending"
  },
  "trending_searches": [
    {
      "query": "coffee festival",
      "search_volume": 50000,
      "increase_percentage": 200
    }
  ]
}