SDK engine

Google Finance

Карточка Google Finance для инструмента: summary, graph, markets, knowledge graph, новости, финансовая отчётность и похожие инструменты.

engine: google_finance TS: XylopSearchEngines.GoogleFinance JS: XylopSearchEngines.GoogleFinance C#: XylopSearchEngines.GoogleFinance Python: XylopSearchEngines.GOOGLE_FINANCE PHP: XylopSearchEngines::GOOGLE_FINANCE Ruby: XylopApiClient::Engines::GOOGLE_FINANCE Java: XylopSearchEngines.GOOGLE_FINANCE Kotlin: XylopSearchEngines.GOOGLE_FINANCE Swift: XylopSearchEngines.googleFinance Dart: XylopSearchEngines.googleFinance C++: xylop::api::engines::google_finance Go: xylop.EngineGoogleFinance 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.GoogleFinance,
  {
    q: "GOOGL:NASDAQ",
    hl: "en",
    window: "1D",
  });

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.GoogleFinance,
  {
    q: "GOOGL:NASDAQ",
    hl: "en",
    window: "1D",
  });

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.GoogleFinance,
    new Dictionary<string, string?>
    {
        ["q"] = "GOOGL:NASDAQ",
        ["hl"] = "en",
        ["window"] = "1D",
    });

Для типизированного режима используйте `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_FINANCE,
    {
        "q": "GOOGL:NASDAQ",
        "hl": "en",
        "window": "1D",
    },
)

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_FINANCE,
    [
        'q' => 'GOOGL:NASDAQ',
        'hl' => 'en',
        'window' => '1D',
    ]
);

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_FINANCE,
  {
    "q" => "GOOGL:NASDAQ",
    "hl" => "en",
    "window" => "1D",
  }
)

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_FINANCE,
    Map.of(
        "q", "GOOGL:NASDAQ",
        "hl", "en",
        "window", "1D"
    ));

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_FINANCE,
    mapOf(
        "q" to "GOOGL:NASDAQ",
        "hl" to "en",
        "window" to "1D",
    ),
)

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.googleFinance,
    parameters: [
        "q": "GOOGL:NASDAQ",
        "hl": "en",
        "window": "1D",
    ]
)

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.googleFinance,
    <String, Object?>{
      'q': 'GOOGL:NASDAQ',
      'hl': 'en',
      'window': '1D',
    },
  );

  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_finance,
        {
            {"q", "GOOGL:NASDAQ"},
            {"hl", "en"},
            {"window", "1D"},
        });

    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.EngineGoogleFinance,
        xylop.Params(map[string]string{
            "q": "GOOGL:NASDAQ",
            "hl": "en",
            "window": "1D",
        }),
        &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_finance
API key
Передается SDK автоматически из настроек клиента.
Входные параметры

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

Параметр Тип Обязателен Значение Описание
api_key SDK string Да Ключ Xylop API. В SDK задается один раз в настройках или конструкторе клиента.
engine SDK string Да google_finance Движок Google Finance.
q string Да GOOGL:NASDAQ Тикер, индекс, фонд, валюта или futures.
hl string Нет en Язык интерфейса.
window string Нет 1D 1D, 5D, 1M, 6M, YTD, 1Y, 5Y или MAX.
Выходные параметры

Поля ответа

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

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

{
  "search_metadata": {
    "status": "Success",
    "google_finance_url": "https://www.google.com/finance/quote/GOOGL:NASDAQ?hl=en"
  },
  "search_parameters": {
    "engine": "google_finance",
    "q": "GOOGL:NASDAQ",
    "hl": "en"
  },
  "summary": {
    "title": "Alphabet Inc Class A",
    "stock": "GOOGL",
    "exchange": "NASDAQ",
    "price": "$176.77",
    "extracted_price": 176.77,
    "currency": "USD",
    "price_movement": {
      "percentage": 1.1960682,
      "value": 2.0999982,
      "movement": "Up"
    }
  },
  "graph": [
    {
      "price": 174.95,
      "currency": "USD",
      "date": "Jun 16 2025, 09:30 AM UTC-04:00",
      "volume": 7413
    }
  ],
  "news_results": [
    {
      "title": "Top news",
      "items": [
        {
          "snippet": "The Best Stocks to Buy With $1,000 Right Now",
          "link": "https://example.com/finance-news",
          "source": "Example Finance"
        }
      ]
    }
  ]
}